SH20-1 043-5 



Customer Information 
Control System (CICS) 
System Programmer's 
Program Product Reference Manual 



Program Nos. 5736-XX6 (DOS-ENTRY) 

5736-XX7 (DOS-STANDARD) 
5734-XX7 (OS-STANDARD V2) 

The IBM Customer Information Control System (CICS) is 
a transaction-oriented, multiapplication data base/data 
communication interface between a System/360 or 
System/370 operating system and user-written application 
programs. Applicable to most online systems,CICS pro- 
vides many of the facilities necessary for standard terminal 
applications: message switching, inquiry, data collection, 
order entry, and conversational data entry. 

CICS is available in three systems - two for DOS users and 
one for OS users. Because the two CICS/DOS systems are 
compatible with each other and with the CICS/OS system, 
it is possible to start with a small data base/data communi- 
cation configuration and move up through DOS into OS. 

This manual provides information essential for persons Who 
have the responsibility to define, prepare, and administer 
CICS in the environment it supports. 



mm 



Sixth Edition (May 1973) 

This edition is a major revision obsoleting SH20-1043-4 and incorporating TNL SN20-2986. 

This edition applies to Version 1, Modification Level 1, of the CICS/DOS-ENTRY (5736-XX6) and 
CICS/DOS-STANDARD (5736-XX7) program products and to Version 2, Modification Level 3, of the 
CICS/OS-STANDARD (5734-XX7) program product; it also applies to all subsequent versions and 
modifications unless otherwise indicated in new editions or Technical Newsletters. 

If changes are made to the information herein, the edition that is applicable and current will be 
indicated in the latest System/360 and System/370 SRL Newsletter (GN 20-0360). 

Copies of this and other IBM publication can be obtained through IBM branch offices. 

A form has been provided at the back of this publication for reader's comments. If this form has been 
removed, address comments to: IBM Corporation, Department J04 1501 California Avenue, Palo Alto, 
California 94304. Comments become the property of IBM. 

€> Copyright International Business Machines Corporation 1971, 1972, 1973 



PREFACE 



This publication contains detailed information necessary to implement 
three IBM program products: CICS/DOS-ENTRY, CICS/DOS-STANDARD, and 
CICS/OS-STANDARD V2. It provides system programmers, system analysts, 
and system administrators with information that is primarily independent 
of the operating system involved; for example, the use of CICS macro 
instructions to selectively generate CICS management programs and 
service programs and selectively prepare system control tables and 
service tables. It is assumed that the reader of this publication has 
some knowledge and/or experience concerning the Basic Telecommunications 
Access Method (BTAM) or has access to persons with such knowledge 
and/or experience. 

This publication should be used in conjunction with the appropriate 
CICS Operations Guide when generating CICS and when preparing the 
system tables that describe the environment CICS is to support. 

Throughout this publication, parentheses are used in the notation 
of CICS macro instructions to indicate those operands where more than 
one applicable parameter can be specified with a single use of the 
operand. Where parentheses are not used, only one parameter at a time 
can be specified as part of the operand. An asterisk in (card) column 
72 indicates that the macro instruction is continued on the next line 
(card) . The first operand on a continuation card must begin in column 
16. 

The words "transaction" and "task" have the same connotation in 
CICS and are used interchangeably throughout this publication; the 
processing of a transaction may involve the execution of one or more 
"programs". 

For further information concerning CICS, see the following IBM 
publications : 

General Information Manual (GH20-1028) 

Application Programmer's Reference Manual (SH20-1047) 

Terminal Operator's Guide (SH20-1 044) 

Operations Guide (CICS/DOS) (SH20-1034) 

Operations Guide (CICS/OS) (SH20-1048) • 

Logic Manual (CICS/DOS-ENTRY) (LY20-0712) 

Logic Manual (CICS/DOS -STANDARD) (LY20-07.13) 

Logic Manual (CICS/OS-STANDARD V2) (LY20-0714) 

All references to CICS/OS and CICS/OS-STANDARD in this publication 
are references to the CICS/OS-STANDARD V2 system. 

Note: Information in this publication concerning TCAM is applicable 

only to the CICS/OS system. Information concerning 3735 support 
is not applicable to CICS/DOS-ENTRY. 



CONTENTS 



Introduction . . 1 

General Description 3 

The Real-Time System Environment 3 

Real-Time System Programming 3 

Preparing the System 4 

System Generation 4 

System Table Preparation 5 

System Maintenance. 5 

System Data Set Considerations. 6 

User Data Base Considerations 7 

User Extrapartition Data Sets 9 

User Exits 10 

Executing the System. 10 

Job Control 10 

System Initialization 11 

Terminating the System 11 

Processing Dump Data Sets 11 

System Generation 13 

General Description 13 

Initialization of System Generation 19 

Control System Operational Group (CSO) 23 

Control System Service Group (CSS) 24 

Control System Dummy Group (CSD) 25 

Control System Utility Group (CSU) 25 

Control System Management Programs 26 

Task Control Program (KCP) 26 

Storage Control Program (SCP) 27 

Program Control Program (PCP) 28 

Program Interrupt Control Program (PIP) 29 

Interval Control Program (ICP) 29 

Dump Control Program (DCP) 31 

Terminal Control Program (TCP) 32 

File Control Program (FCP) 38 

Transient Data Control Program (TDP) 39 

Temporary Storage Control Program (TSP) 41 

Common System Area (CSA) 42 

Master Terminal Program (MTP) 42 

Dynamic Open/Close Program (OCP) 43 

Graphic Attention Program (GAP) 43 

High-Level Language Support Group (HLL) . 43 

Terminal Dependent Control Program (TDCP) 44 

Asynchronous Transaction Processing Group (ATP) 44 

Termination of CICS/DOS System Generation 44 

Generation of CICS/OS Data Language/I Facilities 45 

Defining PSB»s and PCB's 45 

Defining PSB and DMB Directories During CICS Generation 46 

System Table Preparation. ... ..... 48 

System Initialization Table (SIT) 48 

Terminal Control Table (TCT) 53 

Establish Control Section for Terminal Control Table 55 

Specify Data Set Control Information 56 

Describe Communication Lines 61 

Describe Terminal Types 70 

Define Digital Response Messages for 7770 Audio Response Unit . . 76 

Specify End of Terminal Control Table 77 

Terminal Control Table^ Example 77 

File Control Table (FCT) . 80 

Establish Control Section for File Control Table. 82 

Describe Data Set for File Management ....... . . 82 



Describe Cross-Index Data Set Record 87 

Define Header of Segmented Record ..... 89 

Describe Each Segment of a Segmented Record 89 

Describe Segment Sets ..... 90 

Specify Last Segment Set 90 

Specify End of File Control Table 91 

Create Superset ISAM Logic Module (CICS/DOS Only) 91 

File Control Table Example 91 

Destination Control Table (DCT) 93 

Establish Control Section for Destination Control Table 94 

Specify Data Set Control Information 92 

Specify Extrapartition Destinations ..... 97 

Specify Intrapartition Destinations 98 

Specify Indirect Data Destinations 99 

Terminate Entries for the Destination Control Table 100 

Nonresident Extrapartition Data Set Definition 100 

Destination Control Table Examples 100 

Program Control Table (PCT) 104 

Establish Control Section for Program Control Table 105 

Specify Transaction Control Information 105 

Specify End of Program Control Table 106 

Program Control Table Example . 107 

Processing Program Table (PPT) 108 

Establish Control Section for Processing Program Table 108 

Describe Processing Programs 108 

Specify End of Processing Program Table 109 

Processing Program Table Example 109 

System Service Tables 110 

Sign-on Table (SNT) 110 

Terminal List Tables (TLT) 113 

System Programming Considerations 116 

Creating User Exits for CICS Management Programs. . 116 

Creating a Terminal Error Program (DFHTEP) 120 

Terminal Abnormal Condition Line Entry (TACLE) 120 

DFHTEP Programming Considerations 121 

DFHTEP Alternate Interface (CICS/OS Only) 129 

7770 32-Second Timeout Considerations 129 

Writing a Transaction to IPL the System/7 129 

2260 Compatibility for the 3270 . . 130 

CICS Table Preparation for 2260 Compatibility 131 

2260 Model-Dependent Data Stream 132 

Screen Technigues ... 132 

Start of Message Indicator (SMI) 135 

New Line Symbol (NL) 135 

Line Addressing 135 

2848 Lock Feature 135 

2845/2848 Tab Feature 135 

Initiating Transactions ........... 136 

3735 Programming Considerations 137 

System Generation 137 

Terminal Control Table Preparation 137 

Inguiry Mode 137 

CICS/TCAM Interface Considerations 137 

TCAM Application Program Interface 138 

CICS/TCAM Interface 139 

TCAM Device Considerations 146 

TCAM User Exits 148 

CICS/TCAM Startup 150 

CICS/TCAM Abend/Restart 151 

CICS/TCAM Termination 151 

System Administration .... 152 

Real-Time System Administration * . . . 152 

System Control Functions 152 

Master Terminal 152 

Date and Time of Day Control 156 

System Statistics 157 



Dynamic Open/Close Function ... 158 

Open Data Sets (OPEN) 159 

Close Data Sets (CLOSE) . . . . „ . . . . 161 

Switch Dump Data Sets (SWITCH) . . . . 162 

Control System Messages 162 

Appendix A: Required Entries to CICS Control Tables 176 

Appendix B: Examples of Terminal Control Table Preparation .... 179 

Appendix C: CICS/TCAM Program Interrelationship ..... 190 

Appendix D: Terminal Control Table Configurator 194 

Appendix E: File Control Table Configurator 199 

Appendix F: CICS Macro Instructions 200 

Appendix G: Examples of User-Written Transactions. ... 211 

Index 217 



INTRODUCTION 



The IBM Customer Information Control System (CICS) is a 
multi-application data base/data communication interface between OS or 
DOS and user-written application programs. Applicable to most online 
systems, CICS provides many of the facilities for standard terminal 
applications: message switching, inguiry, data collection, order entry, 
and conversational data entry. 

Functions performed by CICS include: 

• Control of a mixed telecommunications network 

• Concurrent management of a variety of programs 

• Controlled access to the data base 

• Management of resources for continuous operation 

• Prioritization of processing 

By eliminating many of the development reguirements for such 
functions of a real-time control system, CICS allows programmers to 
concentrate instead on implementing applications, dramatically reducing 
implementation time and cost. 

Functions needed to support a data base/data communication system 
and standard terminal applications are provided by the following CICS 
management programs: 

• Task Management - Provides its own dynamic multitasking facilities 
necessary for effective, concurrent transaction processing. 
Functions associated with this facility include priority scheduling, 
transaction synchronization, and control of serially reusable 
resources. This CICS facility is in addition to the multitasking 

or multiprocessing facilities of the host operating system. 

• Storage Management - Controls main storage allocated to CICS. 
Storage acguisition, disposition, initialization, and reguest 
gueuing are among the services and functions performed by this 
component of CICS. 

• Program Management - Provides a multiprogramming capability through 
dynamic program management while offering a real-time program fetch 
capability. 

• Program Interrupt Management - Provides for the interception of 
program interrupts by CICS to prevent total system termination. 
Individual transactions that program check are terminated by CICS 
with a dump (if Dump Management is used) , thus preventing the entire 
CICS partition/region from terminating. Under CICS/OS, supports 
the runaway task control function of CICS Time Management. 

• Time Management - Provides control of various optional task 
functions (system stall detection, runaway task control, task 
synchronization, etc.) based on specified intervals of time or the 
time of day. 

• Dump Management - Provides a facility to assist in analysis of 
programs and transactions undergoing development or modification. 
Specified areas of main storage are dumped onto a seguential data 
set, either tape or disk, for subseguent offline formatting and 
printing using a CICS utility program. 



• Terminal Management - Provides polling according to user-specified 
line traffic control as well as user requested reading and writing. 
This facility supports automatic task initiation to process new 
transactions. Optionally, the user can request that certain lines 
be under control of TCAM (rather than BTAM) in which case polling 
and other network control functions are performed by the Message 
Control program (MCP) residing in another partition/region. The 
testing of application programs is accommodated by the simulation 
of terminals through sequential devices such as card readers, line 
printers, disk, tape, etc. 

• File Management - Provides a data base facility using direct access 
and indexed sequential data management. This function supports 
updates, additions, random retrieval, and selective retrieval 
(browsing) of logical data on the data base. Optional access to 
the Data Language/I (DL/I) facility of the IBM Information 
Management System (IMS/360) is also provided under CICS/OS. Use 

of DL/I requires the installation of the IMS/360 Version 2, 
Modification Level 2 (or later) Data Base System (573U-XX6) . 

• Transient Data Management - Provides the optional queuing facility 
for the management of data in transit to and from user-defined 
destinations. This function facilitates message switching, data 
collection, and logging. 

• Temporary Storage Management - Provides the optional general purpose 
"scratch pad" facility. This facility is intended for video display 
paging, broadcasting, data collection suspension, conservation of 
main storage, retention of control information, etc. 

In addition to these management functions, CICS provides system 
service programming to identify terminal operators, to give dynamic 
control of the entire system to a master terminal, to display real-time 
system statistics, to intercept abnormal conditions not handled directly 
by the operating system, and to end operation by gathering summary 
statistics, closing data sets, and returning control to the operating 
system. 



GENERAL DESCRIPTION 



THE REAL-TIME SYSTEM ENVIRONMENT 

The real-time data base/data communications (DB/DC) environment is 
characterized by a number of factors which distinguish it from the 
conventional batch processing environment. For example, the system 
programmer must be aware of considerations inherent to the real-time 
system environment, such as: 

• Transactions are not batched by type, but arrive randomly. 

• Online data storage is expensive, so that storing redundant subsets 
of data is an undesirable approach to providing the data access 
reguired by other applications and programs. 

• Sorting and scanning data prohibits the rapid access needed by a 
single transaction. 

• A number of transactions can simultaneously try to change the same 
data. 

• A terminal user may attempt an unauthorized access of confidential 
data. 

• A (software) recovery capability is reguired to prevent data losses. 

REAL-TIME SYSTEM PROGRAMMING 

The real-time data base/data communications environment (DB/DC) 
differs from the traditional batch processing environment primarily in 
the amount and types of concurrent activities that are likely to occur 
within the system at a given time. Whereas a batch processing system 
schedules each application independently and provides data support 
unigue to each application, a DB/DC system controls many transactions 
arriving on a random nonscheduled basis and provides a data base (with 
integrated data) supporting each application. 

In the conventional batch processing environment, the application 
programmer plans a series of runs to edit batches of input transactions, 
update master files, and write output reports. To optimize total run 
time and streamline the cycle, he must concentrate on careful 
manipulation of data. In accomplishing this, the data becomes 
intricately tied to his program logic and is of little value in other 
applications. 

CICS solves many of these complexities by managing data centrally 
in a data base on behalf of all applications. This relieves the 
application programmer of system management considerations, allowing 
him to concentrate instead on the application, and shifts the 
responsibility for an integrated data base to the system programmer. 

As an effective interface, the system programmer must organize all 
the data and optimize its storage, making tradeoffs between cost of 
storage, performance, and service level according to management 
guidelines. The DB/DC system has a common data set (data base) manager, 
and usually provides the system programmer with specialized interfaces. 



PREPARING THE SYSTEM 

CICS is modularly designed to allow the user to configure a data 
base/data communications system appropriate to his needs. While some 
of the system components are essential, many are optional and can be 
configured into the system under user control. 

CICS modularity allows the user to: 

1. Include or omit functions or components. 

2. Replace or extend a function or component. 

3. Evolve and expand the support of the user's environment. 

4. Conduct maintenance on a component level. 

5. Bring the most current individual components together at 
execution time to support the desired environment. 

To assist the user in tailoring the system to meet his needs, source 
code is distributed to the user which must be assembled to provide the 
specific functions and components the user desires. The detailed 
instructions in preparing the system from the distributed 
machine-readable material is contained in the appropriate CICS 
Operations Guide. 

SYSTEM GENERATION 

CICS provides a system generation facility whereby the user can 
define what CICS-provided functions or components he desires as well 
as certain variables he wants included. The system is then generated 
according to that description. 

CICS provides ten executable management programs which can be 
selected and generated by the user to perform the following functions: 

1. Task Management 

2. Storage Management 

3. Program Management 

4. Program Interrupt Management 

5. Time Management (Interval Control) 

6. Dump Management 

7. Terminal Management 

8. File Management 

9. Transient Data Management 
10. Temporary Storage Management 

In addition to the managment programs, a number of system service 
programs (which run as application programs) can be generated. The 
service functions which these programs provide are: 

1. Sign on/sign off 

2. Master terminal 

3. Supervisor terminal 

4. Operator terminal 

5. System statistics 

6. Abnormal condition handling 

7. Terminal abnormal condition handling 

8. Asynchronous Transaction Processing 

9. System termination 

10. Terminal test 

11. Time of day control 

Two utility programs can also be generated. These are the Dump 
Utility program for formatting and printing the dumps (produced during 
execution), and the High-Level Language Preprocessor which is used to 
prepare the ANS COBOL and PL/I application programs for execution under 



CICS. In the CICS/DOS systems, a special linkage-editor facility is 
also generated for use in preparing the object modules for execution. 

An optional user-defined Common Work Area (CWA) is provided as an 
extension of the Common System Area (CSA) in static main storage. This 
work area is available for the use of all user-written programs and 
can be used to contain user-defined data (which is not to be altered 
by CICS) such as tables, accumulators, and sequence numbers. The length 
of the CWA must be specified during system generation. 

The details concerning how to use the DFHSG macro instruction to 
generate the system are provided in the System Generation section of 
this manual. The necessary JCL is detailed in the appropriate CICS 
Operations Guide. 

SYSTEM TABLE PREPARATION 

CICS is table-oriented. This feature gives the user flexibility in 
describing his terminal, data base, and queuing environments. It allows 
him to describe several versions of existing environments, simplifying 
evolution and growth to new environments. Because of the table 
orientation, the user need change only that part of his environment 
that needs to be changed. 

All tables are specified and constructed by the user with assistance 
provided by CICS. These tables are declarative in nature and are used 
by CICS to control the environment according to the design criteria 
established by the user. Major tables are used to describe System 
Initialization and terminal, data set, and queuing environments. Other 
tables identify user programs, transactions, operators, etc. 

Detailed information on the contents of these tables and the macro 
instruction used to prepare them are provided in the section "System 
Table Preparation". 

The Process Control Information field (PCI) is an optional 
user-defined terminal work area which is provided as an extension of 
the Terminal Control Table (TCT) in static main storage. The PCI is 
associated with a particular TCT terminal entry (TCTTE) and is available 
for the use of all user-written programs that are logically attached 
to that TCTTE. The PCI can be used to contain user-defined data (which 
is not to be altered by CICS) such as user statistics and sequence 
numbers. 

The PCI is a variable-length field (0-255 bytes) which is specified 
during system generation. For CICS/OS, PCI's of fixed length (15 bytes) 
may also be specified during system generation for the purpose of upward 
compatiblity from CICS/OS-STANDARD V1 to CICS/OS-STANDARD V2. The 
length of the PCI is specified during preparation of the TCT. 

S-YSTEM MAINTENANCE 

Because CICS is both modular and table-oriented, maintenance is 
simplified considerably. If a change in the user's environment should 
occur which, in turn, requires a change to a CICS management program 
and/or table, only the affected program or table needs to be generated 
again. This, of course, is also true of any corrections that must be 
applied to the system. To make a correction to a particular program 
only the source code for that program needs to be updated, using the 
appropriate operating system update facility, and then reassembled and 
link edited. 



SYSTEM DATA SET CONSIDERATIONS 

The access methods and record content of the system data sets are 
predefined within CICS. Any required formatting is performed by CICS 
during system initialization or by the maintenance functions. For 
space considerations and requirements, see the appropriate CICS 
Operations Guide. 

The system data sets (files) include: 

• Real-Time Relocatable Program Library 

• Real-time Pre-Located Program Library 

• Transaction Rollout Data Set 

• Dump Data Set 

• Intrapartition Data Set 

• Temporary Storage Data Set 

Re al-T ime Relocatable Program Library 

The Real-Time Relocatable Program Library contains all user programs 
and CICS programs to be loaded and executed in real-time including the 
control system itself and certain user-prepared System Control Tables. 
The library contains program text and, where applicable, a relocation 
dictionary for each program. The contents of this library are 
asynchronously fetched into main storage for real-time execution in 
the CICS/DOS-STANDARD and CICS/OS-STANDARD systems by the Program 
Control Program. This library is not used for real-time execution in 
the CICS/DOS-ENTRY system. 

For the CICS/DOS-STANDARD system, the Real-Time Relocatable Program 
Library is a user allocated extent. Programs are prepared for this 
library by DFHLINK. For the CICS/OS-STANDARD system, the Real-Time 
Relocatable Program Library is a standard partitioned data set. 
Programs are prepared for this library by the OS Linkage Editor. 
CICS/OS users may concatenate other private libraries to this library. 

Real-Time Pre-Lo cate d P rogra m Libra ry 

The CICS Real-Time Pre-Located Program Library is used in the 
CICS/DOS-ENTRY system to retain the nonresident application programs 
during real-time execution. All application programs, so designated 
by the user, are loaded into main storage by the CICS System 
Initialization program and are written into the library for subsequent 
fetch and refresh. The Processing Program Table in main storage serves 
as the directory for this library. 

Tr ans action Rollo ut Data Set 

The Transaction Rollout data set (file) is used in the CICS/DOS-ENTRY 
system to retain certain transaction information in order to support 
conversational interaction with a terminal. The types of transaction 
information that may be expected to be rolled into this data set 
include: 

1. Task Control Area 

2. Transaction Work Area 

3. User-acquired work areas 

4. File, Temporary Storage, Transient Data input/output areas, 
work areas, and control areas 

5. Register storage areas 

6. Loaded programs 



Dump Data Set 

The optional dump data set is used by the Dump Control program to 
record dumps of transactions within the system. It is a sequential 
data set located on either magnetic tape or direct access and can be 
subsequently formatted and printed by the CICS Dump Utility program. 

CICS provides the capability to open/close the active dump data set 
during the real-time execution of the system. Optionally, the user 
can define two dump data sets (DFHDMPA and DFHDMPB) , alternating between 
them during real-time execution of CICS. 

In tr a part it ion Data Set 

The Intrapartition data set is a system option and is used for the 
queuing of user data and, optionally, CICS data by the Transient Data 
Control program (CICS*s general purpose queuing facility). Data, as 
requested, is stored chronologically into this data set according to 
previously identified symbolic destinations for subsequent retrieval 
when all applicable system conditions and facilities are in the 
appropriate status. This data set is reusable and is required for 
applications such as message switching, broadcasting, order 
distribution, etc. The record format for this data set is standard 
System/360 variable length. 

Tem pora ry S to rage Data Set 

The Temporary Storage data set is a system option, and should be 
allocated, if required, by the user as general purpose scratch pad 
storage for use by the Temporary Storage Control program. User data, 
as requested, is stored into this data set under a dynamically-provided 
symbolic identification for subsequent retrieval and release (when 
appropriate) . This data set is intended for applications such as 
broadcasting, video display paging, transaction suspension, main storage 
conservation, etc. This data set consists of variable-length records 
within a preformatted fixed- length DAM data set record and is required 
if the "time ordered" automatic task initiation feature of CICS is 
generated. 

USER DATA BASE CONSIDERATIONS 

CICS File Management allows the user a high degree of flexibility 
when defining the structure of his data base. Individual data sets 
(files) within the data base can be accessed under control of the Direct 
Access Method (DAM) or the Indexed Sequential Access Method (ISAM) . 
The following optional CICS features allow certain variations in data 
organization to provide the user with the most efficient data base 
structure suitable to his environment. 

Segme nt ed Recor ds 

CICS stores data in and retrieves data from the user's data sets. 
It is possible to retrieve an individual record or selected segments 
of an individual record. A segmented record is one in which the 
components of the record have been identified and grouped according to 
frequency of use, function, and logical relationship. The identifiable 
groups are called segments. Some segments are in all records, such as 
those that contain identification or major record control fields. Other 
segments apply only in certain records. The primary reason for 
segmenting records is to conserve main storage, or, in the case of 
variable-length records, to conserve direct access storage. 



If additional information is to be included in a segmented record, 
either a new segment is created or an existing segment is altered. In 
either case, only the affected segment descriptions need be changed 
and the new programming added to support the change. Symbolic 
references to unchanged segments are not affected. Adding information 
to a fixed format record could reguire considerably more programming 
than using the segmented record approach. 

The user must define the record segments to CICS. In addition, each 
record to be retrieved in segments must have control information in 
the first segment which is used to indicate the presence or absence of 
each segment. A segment should contain logically related data so that 
only selected segments are required to satisfy the processing 
requirements of a transaction. A transaction that uses only selected 
record segments requires less main storage fot its processing. 

The user, in selecting those segments necessary for processing 
transaction groups, identifies them to CICS as a part of the data set 
(file) definitions in the File Control Table. Such a group of segments 
is a segment set. A segment set can include a single segment, a number 
of segments, or all segments of a record. When a request is made to 
File Control identifying a segment set in the request, CICS always 
returns the header control segment plus the segments in that set. 

Segmented records can be used with either DAM or ISAM data set 
organizations. For further details concerning segmented records, see 
"Data Base Considerations" in the CICS Application Pr ogramme r 1 s 
Reference Manual (SH20-1047) . 

Deblocking Se r v ic es for DAM Da ta Sets 

CICS provides deblocking of logical records which are blocked and 
written on a direct access (DAM) data set. This service is provided 
for both fixed- and variable-length records. The data set must be 
created according to standard System/360 record formatting conventions. 

Indexed Data Sets - Indirect Acces sin g 

CICS (optionally) allows the use of cross-index data sets to access 
another data set which may be the main data set or another level of 
index data set. If a record retrieved from a cross-index data set 
indicates multiple entries in the main data set, information is returned 
to the user-written application programs to be used in selecting the 
appropriate main data set entry. When the cross index does not indicate 
multiple entries in the main data set, the File Control program reads 
the requested record from the main data set. 

Organization of the cross-index data set may be either indexed 
sequential or basic direct access. The index record contains, in 
addition to the information used to find it, the search argument for 
the record on the data set which the index data set references. The 
index record may contain any other information desired by the user. 
The location of the search argument, it's length, and the data set 
identification for the referenced data set are supplied to CICS as part 
of the data set definitions in the File Control Table. For further 
details concerning indirect accessing, see "Data Base Considerations" 
in the CICS Application Programmer's Reference M anua l (SH20-1047) . 



DOS ISAM Variable-Length Re cord s 

The CICS/DOS systems support the retrieval and static update (no 
length variation) of variable-length logical records within fixed-length 
blocks under an ISAM organization. These pseudo-variable blocks must 
conform to System 360/370 variable-length record format conventions. 
That is, the first four bytes must contain the block length of the form 
LLbb. Since all blocks are fixed length, this value will be the same 
for all blocks. Each logical record within the block must reflect the 
length of the record in the first four bytes (LLbb) . A logical record 
may not be continued onto the next block. The first byte of any unused 
portion of a block must contain a hexadecimal FF. 

The addition and deletion of records on a DOS ISAM variable-length 
record data set must be handled by the user in an offline batch 
environment. When creating the data set, it must be defined as fixed 
unblocked, and the key for each block must be the same as the last 
logical record in that block. The block size must be an even number 
of bytes. All records must reside in the prime data area; no overflow 
records are allowed. For details concerning the CICS definition of a 
DOS ISAM variable- length record data set, see the discussion of the 
File Control Table in the section "System Table Preparation". 

Data Lanq ua qe/I Data Sets 

Optional access to the Data Language/I (DL/I) facility of the IBM 
Information Management System (IMS/360) requires the installation of 
the IMS/360 Version 2, Modification Level 2 (or later) Data Base System 
(5734-XX6) . 

As CICS is initialized, an IMS batch job is attached (via OS) as an 
OS subtask of CICS in much the same fashion as a regular IMS system is 
executed as an OS job. All data sets required for a batch IMS job are 
required for access to DL/I under CICS. 

USER EXTRAPARTITION DATA SETS 

Extrapartition data is the name given in CICS to transient stream 
data which is coming into or going out of the data base/data 
communication system environment. This data is usually coming from or 
going to high-speed magnetic devices and is characterized by, but not 
required to be, blocked, variable-length stream data. The 
extrapartition disposition facility is intended for use with the 
following types of data and applications: 

1. Message logging 

2. Transaction logging 

3. Reconstruction records and information 

4. Data collection 

5. Data entry 

and all other output stream data intended for subsequent processing 
(usually offline). The user defines this data consistent with his 
requirements and facilities. The extrapartition acquisition facility 
is intended for limited stream (batch- like) data processing in the data 
base/data communication environment. 



USER EXITS 

Exit routines may be provided by the user to extend or add functions 
to CICS management programs. All CICS management program exits are 
included at the source level and are assembled with the management 
program during system generation. The user exits provided for are as 
follows: 



CICS MANAGEMENT PROGRAM 
Task Control (DFHKCP) 

Storage Control (DFHSCP) 
Program Control (DFHPCP) 
Interval Control (DFHICP) 

Terminal Control (DFHTCP) 
File Control (DFHFCP) 



Transient Data Control 
(DFHTDP) 



Temporary Storage Control 
(DFHTSP) 



USER EXIT 

Before request analysis 
Before task dispatch 

Before reguest analysis 

After program load 

Before request analysis 

At expiration of time interval 

Before transaction attach 
Before output event initiation 
After input event completion 

Before service reguest analysis 
Before output event initiation 
Before input event initiation 
After input event completion 

Before service request analysis 
Before output event initiation 
After input event completion 

Before service reguest analysis 
Before output event initiation 
After input event completion 



For further information concerning user exits, see the discussion 
of the individual CICS management programs in the section "System 
Generation"; see also the section "Creating User Exits for CICS 
Management Programs". 

EXECUTING THE SYSTEM 

CICS is designed to bring together at execution time the most current 
individual components to support the environment requirements present 
at that time. Through the use of the appropriate System Initialization 
Table and the necessary overrides, any combination of CICS management 
programs and tables may be loaded and executed. Thus, the user may 
have a test module and a standard module of any of the various CICS 
management programs and tables (only one of which may be in main storage 
for a given execution) . He can then execute CICS using the test module; 
if it doesn*t work satisfactorily, he can execute CICS again using the 
standard module that he knows is working. 

JOB CONTROL 

The job control language (JCL) statements needed to execute CICS 
varies not only with the operating system environment desired but also 
with the choice of CICS functions and types of data organization. 
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Specific examples of JCL can be found in the appropriate CICS Operations 
Guide. 

In a CICS/OS environment, a procedure may be set up so that execution 
of a "standard" system requires a minimal amount of JCL to be submitted 
as a job. Only for execution of a test system or for other than the 
defined standard system would a larger JCL deck be necessary. 

In a CICS/DOS environment, the user can elect to use Single Program 
Initiate (SPI) to activate CICS with a minimal amount of JCL. 

SYSTEM INITIALIZATION 

The flexibility in specifying which CICS management programs and 
tables are to be loaded for a particular execution is accomplished 
through the System Initialization program (DFHSIP) . This program is 
named on the EXEC card in the JCL and is used to accomplish the 
following: 

1 . Load the specified System Initialization Table. 

2. Request any overrides that are desired. 

3. Load the requested CICS management programs and tables. 

4. Initialize tables and areas. 

5. Open all required data sets. 

6. Load any resident application programs. 

7. Pass control to the Terminal Control program (which then executes 
as the initial task) . 

TERMINATING THE SYSTEM 

System termination is provided for through use of the master terminal 
transaction (CSMT) and several CICS-provided programs (DFHMTP, DFHSTP, 
DFHSTKC, DFHSTTD, DFHSTTR) . The Termination program (DFHSTP) allows 
normal completion of transactions currently in progress, prepares 
statistics, closes data sets, and optionally, takes a dump before 
exiting to the operating system. 

A detailed description of the use of the transaction CSMT in 
terminating the system is found in the appropriate CICS Operations 
Guide. 

PROCESSING DUMP DATA SETS 

The dump data set produced by the Dump Management facility of CICS 
is a sequential data set, on either magnetic tape or disk, which exists 
in a semi-processed form. The CICS-provided utility program (DFHDDP) 
is used to produce the final formatted dump. The user can define an 
alternate as well as a primary dump data set. 

Unless the user chooses to provide an alternate dump data set, DFHDUP 
must be used only when CICS is not in real-time execution. That is, 
if the user wishes to print the dump data set, he must first terminate 
CICS, run DFHDUP, then reinitialize CICS. This may satisfy the user 
who only requires CICS for a part of the day. 

However, for the user who requires CICS operations for a long period 
of time, an alternate dump data set may be allocated. Thus, at periodic 
intervals, the user may request, through the CICS Master Terminal switch 
function, that CICS begin using the alternate dump data set so that 
the primary data set can be processed by DFHDUP in another 
partition/region. When the primary data set has been processed, the 
user may again "switch" back to the primary data set and then process 
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the alternate data set. This procedure can be repeated any number of 
times. If tapes are being used, this switching procedure causes the 
old dump tape to be closed and dismounted, and a new tape to be mounted 
and opened. 

If the user switches to the alternate dump data set, then fails to 
process the primary data set before again switching, the dumps on the 
primary data set are destroyed by the CICS Dump Management facility 
when new dumps are recorded. 

A detailed description of the use of the Dump Utility program is 
found in the appropriate CICS Operations Guide. 
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SYSTEM GENERATION 



GENERAL DESCRIPTION 

Generation of CICS/DOS is accomplished in three stages: Stage I 
consists of the assembly of the CICS/DOS generation macro instructions 
and- the preparation of the input for Stage II; Stage II consists of 
the assembly of the CICS/DOS system; and Stage III consists of the link 
editing of the non-real-time system and tables used by the System 
Initialization program to the DOS Core Image Library using the DOS 
Linkage Editor (LNKEDT) and the link editing of the CICS/DOS real-time 
system to the CICS/DOS Real-Time Relocatable Program Library (DFHRPL) 
using the CICS/DOS Linkage Editor (DFHLINK) . 

Generation of CICS/OS is accomplished in a two-stage operation: (1) 
assembly of the generation macro statements and (2) the running of the 
job stream produced by this assembly. 

During the generation of CICS, the user must specify the CICS 
management programs and system service programs he reguires to meet 
his environmental needs. The specification and naming of the desired 
programs are accomplished through the use of DFHSG system generation 
macro instructions, which are processed by the Assembler. 

The order in which DFHSG macro instructions are specified is not 
important, except that the first macro instruction specified must be 
the DFHSG TYPE=INITIAL macro instruction. In the CICS/DOS systems, 
the DFHSG TYPE=FINAL macro instruction must be the last statement of 
the system generation input stream preceding the Assembler END 
statement. 

DFHSG macro instructions are written in Assembler language and, as 
all Assembler language instructions, are written in the following 
format: 

Name O per ati on Operands Co mme nts 

blank DFHSG One or more operands 

or separated by commas 

symbol 

In this publication, parentheses are used to indicate those operands 
where more than one applicable parameter (keyword and otherwise) can 
be specified with a single use of the operand. Where parentheses are 
not used, only one parameter at a time can be specified as part of the 
operand; a choice must be made in the case of more than one applicable 
parameter. Since a blank character indicates the end of the operand 
field, the operand field must not contain blanks except after a comma 
on a continued card or after the last operand of the macro instruction. 
The first operand of a continued card must begin in column 16. 

The following operands can be included in the DFHSG macro 
instruction: 

DFHSG TYPE=INITIAL, * 

STATUS=FIRST, * 

ASMBLR=Assembler name, * 

OPSYS= (VS1,VS2, number) , * 

TRACE=YES,NO, * 

TIMECTL=YES,NO, * 

DSIZE=number, * 
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MPS=YES,NO, * 

JOBNAME=jobname, * 

ACCTID=accounting information, * 

PGMERID=» programmer's name 1 , * 

MSGLVL=0,1, * 

DEVICE=2311, 2314, 3330, * 

CONDCD= ( (code, operator) , ..., (code r operator) ) , * 

PRIORTY=nn, * 

MSGCLAS=X, * 

CLASS=jobclass, * 

REGION= (n1K,n2K) , * 

PROCNMS= (procedure names), * 

DL1=YES,N0, * 

ATP=YES,NO, * 

PREFIX=prefix, * 
TCTUA= (V1C0MPAT, VARIABLE) 

DFHSG PROGRAM=CSO, * 

MPS=YES,NO, * 

NSD=number, * 

DEVICE=2311, 2314, 3330, * 

SVC=number, * 

CAA=appendage suffix, * 

V1CMPAT=YES, * 
TCAMSIP=YES 

DFHSG PROGRAM=CSS 

DFHSG PROGRAM=CSD 

DFHSG PROGRAM=CSU, * 
DEVICE= (TAPE, 2311, 2314, 3330) 

DFHSG PROGRAM=KCP, * 

CONSEC=YES, * 

RUNAWAY=YES, * 

STALCTL=YES, * 

ENQOEUE=YES, * 

OPSECUR=YES, * 

ICPTIME=YES, * 

ICPAUTO=YES, * 

ICPSYNC=YES, * 

SUFFlx=program suffix, * 

XTYPREQ=symbolic name, * 

XDSPCHR=symbolic name, * 
DEVICE= (2311,2314,3330) 

DFHSG PROGRAM=SCP, * 

XTYPREQ=symbolic name, * 
SUFFIX=program suffix 

DFHSG PROGRAM=PCP, * 

PCPLOAD=YES,NO, * 

LANG= (COBOL, PL/I) , * 

HLLTR=YES,NO, * 

COBOL= (V2,V3,V4, SUBSET) , * 

XFETCH=symbolic name, * 
SUFFIX=program suffix 

DFHSG PROGRAM=PIP, * 
SUFFIX=program suffix 

DFHSG PROGRAM=ICP, * 

RUNAWAY=YES, * 

ICPTIME=YES, * 
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ICPAUTO=YES, * 

ICPSYNC=YES, * 

SUFFIX=program suffix, * 

XTYPREQ=symbolic name, * 

XICEEXP=symbolic name, * 
DUMMY=YES 

DFHSG PROGRAM=DCP, * 

DEVICE-TAPE, 2311,231**, 3330, * 

DEVADDR=nnn, * 

CICSDMP=YES, * 

SUFFIX=program suffix, * 
DUMMY=YES 

DFHSG PROGRAM=TCP, * 

ACCMETH=(BTAM,BSAM,SAM,BGAM,TCAM) , * 

DEVICE= (14 03,1** 04, 1 ****2, 1443 , 1 445,231 1,231 4, 3330, * 

2501, 2520, 2540, CRLP,DASD, DISK, TAPE) , * 

BT AMDEV= (1030, 10 50, 1050D, 1053,1 130, 1130D, 2020, 2020D, * 

2260, L2260, 2265, 2740, 2740D, 2740-2, 2741C, * 
2741E,2741DC,2741DE, 2760, 2770,27700, 2780, 2780D, * 

2980/1, 2980/2, 2980/4, 3275, 3277, L3277, 3284, * 
L3284, 3286, L3286, 37 3 5D, 7770, SYS/3, SYS/3D, SYS/7, * 

SYS/7D,S/360,S/360D,S/370,S/370D,TWX,BISYNC) , * 

FEATURE=(AUTOANSW,AUTOPOLL,BUFFRECV,PSEUDOBIN) , * 
ANSWRBK=(EXIDVER, TERMINAL, AUTOMATIC, 7770TERM,7770NDLL) , * 

INITRL=YES, * 

LOCKF=YES, * 

WRAPLST=YES, * 

BSCODE= (EBCDIC, ASCII, TRANSCODE) , * 

AUTOTRN=YES, * 

UCTRAN=NO, (EBCDIC, ASCII) , * 

COMPAT=NO, (FORMAT, FULLBUF) , * 

FMT2260=(6X40, 12X40, 12X80, 15X64) , * 

FMT3270= (12X40, 24X80) , * 

SMI=user character, * 

TAB=YES,NO, * 

CONVTAB=(ABB,ABC) , * 

XATTACH=symbolic name, * 

XOUTPUT=symbolic name, * 

XINPUT=symbolic name, * 

XTCMIN=symbolic name, * 

XTCMOUT=symbolic name, * 

TCM3270=YES, * 

TCM7770=YES, * 

BMS=YES,NO, * 
SUFFIX=program suffix 

DFHSG PROGRAM=FCP, * 

CONSEC=YES, * 

FILSERV=(INDA,INIS,DAUPD,ISUPD,DAADD,ISADD,INDIRACC, * 

EXCTL,INSEG,OUTSEG,DABLKNG,VLR,HEXAD,DECAD, * 

ACTAD,IVBR, LOCATE, IBROWSE,DBROWSE) , * 

SUFFIX=program suffix, * 

XTYPREQ=symbolic name, * 

XOOTPUT=symbolic name, * 

XINPUT=symbolic name, * 

XINPUTC=symbolic name, * 
DUMMY=YES 

DFHSG PROGRAM=TDP, * 

INTRA=YES,TRANSINIT, * 

EXTRA= (ACQUISITION, DISPOSITION) , * 

SUFFIX=program suffix, * 

DEVICE=2311, 2314, 3330, * 
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XTYPREQ=symbolic name, * 

XOUTPUT=symbolic name, * 

XINPUT=symbolic name, * 
DUMMY=YES 

DFHSG PROGRAM=TSP, * 

DEVICE=2311, 2314, 3330, * 

SUFFIX=program suffix, * 

VIRTUAL=VIRTUAL,REAL, * 

XTYPREQ=symbolic name, * 

XOUTPUT=symbolic name, * 

XINPDT=symbolic name, * 
DUMMY=YES 

DFHSG PROGRAM=CSA, * 

WRKAREA=number, * 

SUFFIX=program suffix 

DFHSG PROGRAM=MTP, * 

TLT=YES,NO 

DFHSG PROGRAM=OCP 

DFHSG PROGRAM=GAP 

DFHSG PROGRAM=HLL, * 

LANG= (COBOL, PL/I) , * 

PL1 = (0,F) 

DFHSG PROGRAM=DDM 

DFHSG PROGRAM=ATP, * 

INBUFF=number, * 

OUTBUFF=number 

DFHSG TYPE=FINAL 

Table 1 shows the symbolic names and program codes used during CICS 
generation in the specification and naming of CICS management programs 
and system service programs. 
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Table 1 (Part 1 of 2) . 



Symbolic names and program codes used in system 
generation 



PROGRAM NAME 


SYMBOLIC NAME 


PROGRAM CODE 




(Note if 




(Not€ 


> 2) 


Terminal Control 


DFHTCP (Note 


6) 


TCP 




3270 Basic Mapping 


DFHBMSMM 




TCP 




Support 










Terminal Dependent 










Control 


DFHTDCP 




Note 


9 


Task Control 


DFHKCP (Note 


6) 


KCP 




File Control 


DFHFCP (Note 


6) 


FCP 




Program Control 


DFHPCP (Note 


6) 


PCP 




Storage Control 


DFHSCP (Note 


6) 


SCP 




Dump Control 


DFHDCP (Note 


6) 


DCP 




Transient Data 










Control 


DFHTDP (Note 


6) 


TDP 




Common System Area 


DFHCSA (Note 


6) 


CSA 




CICS Dummy CSA 


DFHDCSA 




Note 


10 


Temporary Storage 


DFHTSP (Note 


6) 


TSP 




Control 










Interval Control 


DFHICP (Note 


6) 


ICP 




Program Interrupt 


DFHPIP (Note 


6) 


PIP 




Dump Utility 


DFHDUP 




CSU 




CICS/DOS Linkage Editor 


DFHLINK 




INITIAL 


Master Terminal 


DFHMTPA 




MTP 




programs 


DFHMTPB 
DFHMTPC 
DFHMTPD 
DFHMTPE 
DFHMTPF 




MTP 
MTP 
MTP 
MTP 
MTP 




Asynchronous Trans- 


DFHATP 




ATP 




action Processor 










Asynchronous Trans- 


DFHRD1 




ATP 




action Reader 


DFHRD2 




ATP 




Asynchronous Trans- 


DFHWT1 




ATP 




action Writer 


DFHWT2 




ATP 




Asynchronous Trans- 


DFHAQP 




ATP 




action Queue Purge 










Dynamic Open/Close 


DFHOCP 




OCP 




Graphic Attention 


DFHGAP 




GAP 




System Service 










programs 






CSS 




Sign-On 


DFHSNP 




Note 


3 


Sign-Off 


DFHSFP 




Note 


3 


Field Engineering 


DFHFEP 




Note 


3 


Control System Dummy 










programs 






CSD 




Transient Data dummy 


DFHTDPDY 




Note 


4 


Dump Control dummy 


DFHDCPDY 




Note 


4 


File Control dummy 


DFHFCPDY 




Note 


4 


Temporary Storage 


DFHTSPDY 




Note 


4 


dummy 










Interval Control 


DFHICPDY 




Note 


4 


dummy 










Control System 










Operational programs 






CSO 




Abnormal Condition 


DFHACP 




Note 


5 


Terminal Abnormal 


DFHTACP 




Note 


5 


Condition 










Time Adjustment 


DFHTAJP 




Note 


5 


Transmission Error 


DFHTEP 




Note 


5 


System Initialization 


DFHSIP 




Note 


5 



PROGRAM TYPE 



Control program 
Service program 



Service 
Control 
Control 
Control 
Control 
Control 

Control 
Control 
Control 
Control 

Control 
Control 
Service 
Service 
Service 
Service 
Service 
Service 
Service 
Service 
Service 

Service 
Service 
Service 
Service 
Service 

Service 
Control 

Service 
Service 
Service 
Service 

Control 
Control 
Control 
Control 
Control 



program 
program 
program 
program 
program 
program 

program 
program 
program 
program 

program 
program 
program 
program 
program 
program 
program 
program 
program 
program 
program 

program 
program 
program 
program 
program 

program 
program 

program 
program 
program 
program 

program 
program 
program 
program 
program 



Control program 



Control program 
Service program 
Service program 

Service program 
Service program 
Control program 
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Table 1 (Part 2 of 2) . 



Symbolic names and program codes used in system 
generation 



PROGRAM NAME 


SYMBOLIC NAME 
(Note 1) 


PROGRAM CODE 
(Note 2) 


PROGRAM 


TYPE 


System Termination 


DFHSTP 


Note 


5 


Service 


program 


System Statistics 


DFHSTTR 


Note 


5 


Service 


program 


programs 


DFHSTTD 


Note 


5 


Service 


program 




DFHSTKC 


Note 


5 


Service 


program 


Trace programs 


DFHTRP 


Note 


5 


Service 


program 




DFHTRPDY 


Note 


5 


Service 


program 


7770 Read/Write 


DFHRWP70 


Note 


5 


Feature 


program 


7770 Channel/Abnormal 


DFHCAA70 


Note 


5 


Appendage 


End Appendage 












7770 SVC 


DFHDEB70 


Note 


5 


SVC 




DL/I Interface 


DFHDLI 


Note 


11 


Feature 


program 


DL/I Interface dummy 


DFHDLIDY 


Note 


4 


Feature 


program 


DL/I Initialization 


DFHDLA 


Note 


11 


Feature 


program 


DL/I Application 


DFHDLQ 


Note 


11 


Feature 


program 


DL/I CALL Execution 


DFHDLE 


Note 


11 


Feature 


program 


High-Level Language 












programs 




HLL 




Feature 


program 


PL/I-OPT Entry 












Interface 


DFHPL10I 


Note 


7 


Feature 


program 


PL/I-F Entry Interface 


DFHPL1I 


Note 


7 


Feature 


program 


PL/I Interface 


DFHSAP 


Note 


7 


Feature 


program 


CICS Preprocessor 


DFHPRPR 


Note 


8 


Feature 


program 



Note 


1; 


Note, 


2: 


Note. 


3: 



The symbolic name is the name supplied to the linkage edit 
procedure. 

The program code is the keyword parameter used in the system 
generation macro instruction (DFHSG) . 

These programs are included in CICS if the user specifies 
the system service programs with a DFHSG PROGRAM=CSS macro 
instruction. 



Note ,.4; These programs are included in CICS if the user specifies 
the control system dummy programs with a DFHSG PROGRAM=CSD 
macro instruction. 

Not e . . 5 ^ These programs are included in the generation of CICS if 

the user specifies the control system operational programs 
with a DFHSG PROGRAM=CSO macro instruction. 

Note 6: A two-character suffix (other than * DY 1 and 'NO 1 which are 
reserved) may be appended to these symbolic names. Suffix 
•DY 1 is reserved for dummy programs. 

Note 7: These programs are included in CICS if the user specifies 
the high-level language feature with a DFHSG PROGRAM=HLL, 
LANG=PL/I macro instruction. PLI=(0,F) causes appropriate 
program selection. 

Note 8: This program is included in CICS if the user specifies the 
high-level language feature with a DFHSG PROGRAM=HLL, 
LANG= (COBOL, PL/I) macro instruction. 

Note 9: This program is included in CICS if the user specifies 
BTAMDEV=1030. 
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Note 10:, For CICS/OS, this program is given control by the System 
Initialization program (DFHSIP) via an OS XCTL macro 
instruction to function as the Reguest Block (RB) for CICS. 

Note, 11: These programs are included in CICS if the user specifies 
DL1=YES in the DFHSG TYPE=INITIAL macro instruction. 

INITIALIZATION OF SYSTEM GENERATION 

The DFHSG TYPE=INITIAL macro instruction must be the first of the 
system generation macro instructions. Procedures developed from the 
use of this macro instruction can be reused for subseguent generations 
of the entire system or for parts of the system. The following operands 
can be included in this macro instruction: 

DFHSG TYPE=INITIAL, * 

STATOS=FIRST r * 

ASMBLR=Assembler name, * 

OPSYS= (VS1,VS2, number) , * 

TRACE=YES,NO, * 

TIMECTL=YES,NO, * 

DSIZE=number, * 

MPS=YES,NO, * 

JOBNAME=jobname, * 

ACCTID=accounting information, * 

PGMERID= I programmer ■s name', * 

MSGLVL=0,1, * 

DEVICE=2311, 2314, 3330, * 

CONDCD= ( (code, operator) , . . . , (code, operator) ) , * 

PRIORTY=nn, * 

MSGCLAS=x, * 

CLASS=jobclass, * 

REGION=(nlK,n2K) , * 

PR0CNMS= (procedure names) , * 

DL1=YES,NO, * 

ATP=YES,NO, * 

PREFIX=prefix, * 
TCT0A= ( VI COMP AT, VARIABLE) 

TYPE: The TYPE=INITIAL operand specifies that this is the initial macro 
instruction in a CICS system generation run. 

STATUS: In the CICS/DOS systems, the STATUS=FIRST operand must be used 
during the very first CICS/DOS system generation. The presence of this 
operand results in the generation of the CICS/DOS Linkage Editor and 
Library Maintenance program (DFHLINK) . This program is used to place 
all CICS management and application programs in the Real-Time 
Relocatable Program Library (DFHRPL) . 

Once the generation of DFHLINK is complete, it is used to format 

the Real-time Relocatable Program Library. The user must provide a 

label set for DFHNPL in the partition standard label definitions and 
include the DSIZE operand. 

In the CICS/OS system, the STATOS=FIRST operand is used to cause 
the CICS cataloged procedures to be placed in SYS1.PROCLIB. If 
TCTUA=V1C0MPAT is specified, jobs are created during stage II of system 
generation that modify the DFHTCT macro and DFHTCT symbolic storage 
definition (DSECT) to provide upward compability from CICS/OS Version 
1 to CICS/OS Version 2. 
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ASMBLR: This operand is used to identify the name of the Assembler to 
be used during Stage II of system generation and to produce the proper 
JCL. The default is ASMBLR=ASSEMBLY for CICS/DOS and ASMBLR=IEUASM 
for CICS/OS. 

For CICS/OS, if the first three characters of the Assembler name 
are ' IEV*, Assembler H is assumed and only one work data set is 
allocated (SYSUT1) . Otherwise, Assembler F is assumed and three work 
data sets are allocated (SYSUT1, SYSUT2, and SYSUT3) . 

TRACE: The TRACE=NO operand is used to indicate that the optional 
trace function is not to be used during execution of CICS. The default 
is TRACE=YES. 

TIMECTL: The TIHECTL=NO operand is used to indicate that none of the 
optional time management functions are to be included in any of the 
CICS management programs. If TIMECTL=NO is specified, the macro 
instructions of the Interval Control program (ICP) are not expanded 
and warning messages appear on the assembly listings of the affected 
CICS management programs. The time management functions excluded 
include runaway task control and support of ICP macro instructions. 
The default is TIMECTL=YES. 

DSIZE: Applicable only to the CICS/DOS systems, this operand is used 
to specify the number of directory tracks to be used for the Real-Time 
Relocatable Program Library (created if the STATUS=FIRST operand is 
included) . The default is DSIZE=2. 

MPS: Applicable only to the CICS/DOS systems, this operand is used to 
indicate whether the DOS system for which CICS is being generated has 
multiprogramming system (MPS) support. The default is MPS=YES. 

JOBNAME: This operand is used to specify a JCL (OS) or job control 
(DOS) jobname for systems generation. The default name is CICS. The 
entire jobname is a concatenation of the jobname operand (truncated to 
four positions) , program name, and suffix. (Example: JOBNAME=NEW, 
PROGRAM=KCP, SUFFIX=01.) The jobname would be NEWKCP01. For the default 
jobname operand, PROGRAM=KCP, SOFFIX=03. The jobname would be CICSKCPO. 
The combined jobname will be truncated to eight positions. 

Note: The program name for DFHSG TYPE=INITIAL is provided by the system 
as GEN. Therefore the default jobname is CICSGEN. 

ACCTID: Applicable only to the CICS/OS-STANDARD system, this operand 
is used to specify the JCL accounting information for the system 
generation procedure. The default is ACCTID=CICSGEN. 

PGMERID: Applicable only to the CICS/OS-STANDARD system, this operand 
is used to specify the programmer's name to be placed in the JCL. The 
name must be enclosed in quotation marks and should not exceed 20 
positions. The default is PGMERID=» SYSTEM PROGRAMMER 1 . 

MSGLVL: Applicable only to the CICS/OS-STANDARD system, this operand 
is used to specify the message level desired for the JCL during Stage 
II. The default is MSGLVL=0. 
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DEVICE: Applicable only to the CICS/DOS systems, this operand specifies 
for DFHLINK the device type on which the Real-Time Relocatable Program 
Library is resident. This operand is propagated to the DEVICE= 
parameters of DFHSG TYPE=CSO and TYPE=KCP. The default is 2311. 

OPSYS: Applicable only to the CICS/OS STANDARD system (release 2.3 or 
later) this operand is used to specify the VS environment in which CICS 
is to be run. For example, OPSYS= (VS1 ,1) is the decimal release number 
of the operating system. In the case of release 2.3, the fix for APAR 
No. P10780 must also be applied. 

CONDCD: Applicable only to the CICS/OS-STANDARD system, this operand 
is used to specify up to eight condition codes which, if met on any 
job step, cause further processing of that job to be bypassed. "code" 
can be any decimal number from through 4095. "operator" can be any 
of the following: GT, GE, EQ, IT, LE, NE. For further details, see 
the publication OS Job Control Languag e (GC2 8-67 04) . 

PRIORTY: Applicable only to the CICS/OS-STANDARD system, this operand 
is used to assign a priority to the jobs in Stage II of system 
generation. All jobs are given the same priority, where "nn" can be 
any decimal number from through 13. For further details, see the 
publication OS Job Cont rol La ngu age (GC28-67 04) . 

MSGCLAS: Applicable only to the CICS/OS-STANDARD system, this operand 
is used to route all messages issued by the OS Job Scheduler to an 
output class other than the normal message class (A) . "x" can be any 
alphabetic (A-Z) or numeric (0-9) character. If this operand is 
omitted, or if MSGCLAS=A is specified, job scheduler messages are routed 
to the standard output class, A. For further details, see the 
publication OS Job Control La nguage (GC2 8-67 04) . 

CLASS: Applicable only to the CICS/OS-STANDARD system, this operand 
is used to assign a jobclass to all Stage II jobs. "jobclass" can be 
an alphabetic character A through 0. If this operand is omitted, or 
if CLASS=A is specified, A is the default jobclass assigned to the 
jobs. For further details, see the publication OS Job Contr ol Language 
(GC28-6704) . 

REGION: Applicable only to the CICS/OS-STANDARD system, this operand 
allows the user to (1) specify the maximum amount of main storage to 
be allocated to the job, or (2) specify the maximum amount of main 
storage to be allocated to the job and specify in which storage 
heirarchy or heirarchies (if OS/HVT is generated with heirarchy support) 
the space is to be allocated. 

. If REGION=n1K is specified (for example, REGION=52K) , "n1" indicates 
the number of contiguous 1024-byte areas of main storage to be allocated 
for the job (n1 should be an even number and must not exceed 16383) . 
If REGI0N=(nlK,n2K) is specified (for example, REGI0N= (60K, 150K) , "n1" 
indicates the number of contiguous 1024-byte areas to be allocated in 
main storage (hierarchy 0) , and "n2" indicates the number of contiguous 
1024-byte areas to be allocated in LCS (heirarchy 1) . For further 
I details, see the publication OS Job Control Language (GC28-6704) . 

If this operand is omitted, the default value (as established in 
the input reader procedure) is assumed. 
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PROCNMS: Applicable only to the CICS/OS-STANDARD system, this operand 
allows the user to specify the names of CICS cataloged procedures to 
be used as follows: (1) First Name - assembly of CICS programs and 
user-written Assembler language programs, (2) Second Name - link edit 
of CICS programs and application programs, (3) Third Name - update of 
a temporary library during system generation, (4) Fourth Name - assembly 
and link edit during the preparation of system tables. The default is 
PROCNMS= (DFHASMV2,DFHLNKV2,DFHUPDV2,DFHAUPLK) . 

DL1: Applicable only to the CICS/OS-STANDARD system, this operand 
allows the user to specify whether or not the Data Language/I (DL/I) 
interface is to be included in this generation of CICS. The default 
is DL1=N0. 

Note; The Program Specification Directory (PDIR) and Data Management 
Block Directory (DDIR) lists must be in CICS.LOADLIB for the 
link edit of the CICS-DL/I interface modules. Therefore, if 
DL/I is being generated, the lists must be assembled and link 
edited before Stage II of system generation is executed. For 
further information, see the section "Generation of CICS/OS Data 
Language/I Facilities". 

ATP: Applicable only to the CICS/OS-STANDARD and CICS/DOS-STANDARD 
systems, this operand allows the user to specify whether or not 
Asynchronous Transaction Processing (ATP) support is to be included in 
this generation of CICS. The default is ATP=NO. 

PREFIX: Applicable only to the CICS/OS-STANDARD system, this operand 
is used to specify the index name for CICS system data sets. The Job 
Control Language (JCL) generated specifies these data sets as 
prefix. LOADLIB, prefix. MACLIB, and prefix. SOURCE, where "prefix" can 
contain from one to eight characters and must conform to the data set 

| naming conventions outlined in the publication OS Job C ontr ol Language 

J (GC28-6704) . The default is PREFIX=CICS. 

TCTUA: This operand is used to specify user-defined Process Control 
Information (PCI) fields of fixed length (15 bytes) and/or variable 
length (0-255 bytes) . These fields are located in the Terminal Control 
Table and can be used as terminal work areas. 

| TCTUA=V1CMPAT should only be used by CICS/OS Version 1 users who 
are currently using the fixed-length 15-byte PCI field (the address of 
which is at TCTTECI) and who desire Version 2 PCI compatibility with 
Version 1. This operand must be specified in conjunction with the 
STATUS=FIRST operand. 

TCTUA=VARIABLE is used to specify a variable-length (byte aligned) 
PCI field (the address of which is at TCTTECIA and the length of which 
is at TCTTECIL) and should be used by all but CICS/OS Version 1 users 
(who have used PCI fields) if a terminal work area is desired. The 
default is TCTUA=VARIABLE. 
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CONTROL SYSTEM OPERATIONAL GROU P (CSO) 

The system generation macro instruction necessary to generate the 
Control System Operational group is: 

DFHSG PROGRAM=CSO, * 

MPS=YES,NO, * 

NSD=number, * 

DEVICE=2311,23m,3330, * 

SVC=number, * 

CAA=appendage suffix, * 

V.1CMPAT=YES, * 
* TCAMSIP=YES 

The following Control System Operational modules are generated in 
response to this macro instruction: 

1. System Initialization program (DFHSIP) and its overlays 

2. Trace Control program (DFHTRP) , unless TRACE=NO was specified 
in the DFHSG TYPE=INITIAL macro instruction 

3. A dummy trace program (DFHTRPDY) , unless TRACE=NO was specified 
in the DFHSG TYPE=INITIAL macro instruction 

4. System Termination program (DFHSTP) 

5. Abnormal Condition program (DFHACP) 

6. Terminal Abnormal Condition program (DFHTACP) 

7. Terminal Error program (DFHTEP) 

8. Time Adjustment program (DFHTAJP) , unless TIMECTL=NO was 
specified in the DFHSG TYPE=INITIAL macro instruction 

9. File and Terminal Statistics program (DFHSTTR) 

10. Supervisory Statistics programs (DFHSTKC) 

11. Data Management Statistics program (DFHSTTD) 

12. Real-Time Pre-Located Program Library DTF - CICS/DOS systems 
only 

13. 7770 Read/Write program (DFHRWP70) - CICS/OS-STANDARD system 
only, and only if SVC and CAA operands are specified 

14. 7770 Channel/Abnormal End Appendage program (DFHCAA70) - 
CICS/OS-STANDARD system only, and only if SVC and CAA operands 
are specified 

15. 7770 SVC program (DFHDEB70) - CICS/OS-STANDARD system only, and 
only if SVC and CAA operands are specif eid 

16. DL/I Interface program (DFHDLI) - CICS/OS-STANDARD system only, 
and only if DL1=YES was specified in the DFHSG TYPE=INITIAL 
macro instruction 

17. DL/I Interface dummy program (DFHDLIDY) - CICS/OS-STANDARD system 
only, and only if DL1=YES was specified in the DFHSG TYPE=INITIAL 
macro instruction 

18. DL/I Initialization program (DFHDLA) - CICS/OS-STANDARD system 
only, and only if DL1=YES was specified in the DFHSG TYPE=INITIAL 
macro instruction 

19. DL/I Application program (DFHDLQ) - CICS/OS-STANDARD system 
only, and only if DL1=YES was specified in the DFHSG TYPE= INITIAL 
macro instruction. 

20. DL/I CALL Execution program (DFHDLE) - CICS/OS-STANDARD system 
only, and only if DL1=YES was specified in the DFHSG TYPE=INITIAL 
macro instruction 

PROGRAM: The PROGRAM=CSO operand is used to indicate that the Control 
System Operational group is being generated. 

MPS: The MPS=NO operand is used to indicate that the DOS system for 
which CICS/DOS is being generated does not have multiprogramming system 
(MPS) support. The default is MPS=YES. Applicable only to the CICS/DOS 
systems. 
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NSD: Applicable only to the CICS/DOS systems, this operand is used to 
specify the maximum number of nonsequential disk extents that will 
exist for any data set involved in the real-time execution of CICS. 
CICS system generation uses this value to determine the amount of main 
storage to be reserved at the beginning of the partition for label 
processing when the data sets are opened. Although most data sets are 
opened during system initialization, the dynamic open/close feature of 
the CICS Master Terminal program may require the use of this label 
processing area at any time during CICS execution. The presence of 
this operand makes it unnecessary for the user to supply a DOS LBLTYP 
job control statement with his CICS execution deck. If this operand 
is omitted, the default is NSD=9. 

DEVICE: Applicable only to the CICS/DOS systems, this operand is used 
to specify the type of device upon which the Relocatable Program Library 
and the Real-Time Pre-Located Program Library (DOS-ENTRY only) are to 
reside. The default is the value propagated from the DEVICE= operand 
Of DFHSG TYPE=INITIAL. 

SVC: Applicable only to the CICS/OS-STANDARD system, this operand is 
used to specify the SVC number under which the 7770 SVC routine provided 
by CICS is to be link edited to SYS1.SVCLIB. The number specified must 
be in the range 200-255. The default is SVC=200 for system generation 
purposes; however, the SVC is not link edited. This operand is required 
if the ACCMETH=BTAM and BTAMDEV=7770 operands are included in the DFHSG 
PROGRAM=TCP macro instruction. For information concerning adding SVC 
routines to the operating system, see the publication OS System 
Programm er' s Guide (GC28-6550) . 

CAA: Applicable only to the CICS/OS-STANDARD system, this operand is 
used to specify the two-character alphameric suffix to be assigned to 
the 7770 Channel End/Abnormal End Appendage routine provided by CICS 
when that routine is link edited to SYS1.SVCLIB. The suffix specified 
must be in the range WA-Z9. This operand is required if the 
ACCMETH=BTAM and BTAMDEV=7770 operands are included in the DFHSG 
PROGRAM=TCP macro instruction and if the APPENDG operand is included 
in the DFHTCT TYPE=SDSCI macro instruction during preparation of the 
Terminal Control Table. For information concerning adding appendages 
to the operating system, see the publication OS System Pr ogrammer 1 s 
Guide (GC28^6550) . 

V1CMPAT: Applicable only to the CICS/OS STANDARD system, V1CMPAT=YES 
must be specified if the user wishes to have the Terminal Abnormal 
Condition program (DFHTACP) provide a CICS/OS Version 1 interface when 
linking to the user-written Terminal Error program (DFHTEP) under 
CICS/OS Version 2. This operand is to be used only by those former 
CICS/OS Version 1 users who have an existing DFHTEP. 

TCAMSIP: Applicable only if TCAM is used in the CICS/OS-STANDARD 
system, this operand is used to generate TCAM support in the System 
Initialization program (DFHSIP) . 

CONTROL SYSTE M SERVICE GROUP (CSS) 

The system generation macro instruction necessary to generate the 
Control System Service group is: 

DFHSG PROGRAM=CSS 
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The programs generated by this macro instruction are as follows: 

1. Sign-on program (DFHSNP) 

2. Sign-off program (DFHSFP) 

3. F.E. Terminal Test program (DFHFEP) 

CONTROL SYSTEM DUMMY GROUP (CSD) 

If the user does not reguire a particular CICS management program 
(for example. File Control) , he can elect to not generate that program 
and, as a result, save the amount of static main storage that would be 
reguired to contain the program. However, a dummy program must be 
provided for every CICS management program not actually generated. 

If the Control System Dummy group is generated in response to the 

DFHSG PROGRAM=CSD 

macro instruction, dummy programs with the suffix 'DY' are produced 
for the following: 

1. File Control program 

2. Transient Data Control program 

3. Dump Control program 

4. Temporary Storage Control program 

5. Interval Control program 

6. DL/I Interface program 

This facility permits all dummy programs to be generated without 
generating each one separately. 

CONTROL SYSTEM UTILITY GROUP (CSU) 

The system generation macro instruction necessary to generate the 
Control System Utility group is: 

DFHSG PROGRAM=CSU, 

DEVICE= (TAPE, 231 1,2314, 3330) 

The Dump Utility program (DFHDUP) is generated in response to this 
macro instruction. 

PROGRAM: The PROGRAM=CSU operand indicates that the Control System 
Utility group (currently consistently only of DFHDUP) is to be 
generated. 

DEVICE: Applicable only to the CICS/DOS systems, this operand is used 
to specify the type (s) of input devices (s) . The default is 
DEVICE= (TAPE, 2311, 2314, 3330) . 
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CONTROL SYSTEM MANAGEMENT PROGRAMS 

TASK CONTROL PROGRAM (KCP) 

The system generation macro instruction necessary to generate the 
Task Control program is as follows: 

DFHSG PROGRAM=KCP, * 

CONSEC=YES, * 

RUNAWAY=YES, * 

STALCTL=YES, * 

ENQOEUE=YES r * 

OPSECUR=YES, * 

ICPTIME=YES, * 

ICPAUTO=YES, * 

ICPSYNC=YES, * 

SUFFIX=program suffix, * 

XTYPREQ=symbolic name, * 

XDSPCHR=symbolic name, * 
DEVICE= (231 1,2314,3330) 

Unless otherwise indicated, the omission of an operand results in 
the corresponding function not being included. 

PROGRAM: The PROGRAM=KCP operand indicates that the Task Control 
Program is to be generated. 

CONSEC: Applicable only to the CICS/DOS-ENTRY system, the CONSEC=YES 
operand causes logic to be generated in Task Control that limits the 
number of consecutive I/O's initiated by File Control. When the 
specified limit (contained in the CSA at CSAKCCDL) is reached, the task 
is rolled out. This consecutive dispatch limit is specified in the 
System Initialization Table. 

RUNAWAY: The RUNAWAY=YES operand indicates that the optional runaway 
task control feature of Interval Control is to be supported by Task 
Control. 

STALCTL: The STALCTL=YES operand indicates that the optional stall 
detection feature of Task Control is to be included in CICS. 

ENQUEUE: The ENQUEUE=YES operand indicates that the optional 
engueue/degueue feature of Task Control is to be included in CICS. 
This operand must be included if the exclusive control feature is to 
be generated as part of the File Control program. 

OPSECUR: The OPSECUR=YES operand indicates that the optional operator 
security checking feature of Task Control is to be included in CICS. 

ICPTIME: The ICPTIME=YES operand indicates that the optional 
time-of-day feature of Interval Control is to be supported by Task 
Control. 

ICPAUTO: The ICPAUTO=YES operand indicates that the optional automatic 
task initiation feature of Interval Control is to be supported by Task 
Control. 
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ICPSYNC: The ICPSYNC=YES operand indicates that the optional task 
synchronization service of Interval Control is to be supported by Task 
Control. 

SUFFIX: This operand is used to provide a two-character alphameric 
suffix for the Task Control program being assembled. If this operand 
is omitted, a suffix is not provided. 

XTYPREQ: This operand is used to generate linkage to a user-written 
exit routine at the point in Task Control prior to determining what 
type of reguest for task services was issued. For further information 
concerning user exits, see the section "Creating User Exits for CICS 
Management Programs". 

XDSPCHR: This operand is used to generate linkage to a user-written 
exit routine at a point in the Task Dispatcher subsequent to determining 
which task to dispatch but prior to passing control to the task. For 
further information concerning user exits, see the section "Creating 
User Exits for CICS Management Programs". 

DEVICE: Effective only in the CICS/DOS-ENTRY system, a rollout data 
set DTF is generated for the device (s) specified. The default is the 
value propagated from the DEVICE= operand of DFHSG TYPE= INITIAL. 

STORAGE CONTROL PROGRAM (SCP) 

The system generation macro instruction necessary to generate the 
Storage Control program is: 

DFHSG PROGRAM=SCP, * 

XTYPREQ=symbolic name, * 

SUFFIX=program suffix 

PROGRAM: The PROGRAM=SCP operand indicates that the Storage Control 
program is to be generated. 

XTYPREQ: This operand is used to generate linkage to a user-written 
exit routine at the entry point of Storage Control. For further 
information concerning user exits, see the section "Creating User Exits 
for CICS Management Programs". 

SUFFIX: This operand is used to provide a two-character alphameric 
suffix for the Storage Control program being assembled. If this operand 
is omitted, a suffix is not provided. 
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PROGRAM CONTROL PROGRAM (PCP) 

The system generation macro instruction necessary to generate the 
Program Control program is: 

DFHSG PROGRAM=PCP, ■* 

PCPLOAD=YES r NO, * 

LANG= (COBOL, PL/I) , * 

HLLTR=YES,NO, * 

C0B0L=(V2,V3,V4, SUBSET) , * 

XFETCH=symbolic name, * 
snFFIX=program suffix 

Unless otherwise indicated, the omission of an operand results in 
the corresponding function not being included. 

PROGRAM: The PROGRAM=PCP operand indicates that the Program Control 
program is to be generated. 

PCPLOAD: The PCPLOAD=NO operand is used to specify that the optional 
support for the Program Control Load feature is not to be generated. 
PCPLOAD=YES must be specified in order to use a Sign-on Table or a 
Terminal List Table or if application programs use the DFHPC TYPE=LOAD 
macro instruction. See System Service Tables. The default is 
PCPLOAD=YES. 

LANG: This operand is used to specify that the optional support for 
ANS COBOL and/or PL/I is to be generated. 

HLLTR: This operand is used to specify that support for DFHTR (trace) 
macro instructions is to be generated for high-level language 
application programs. If this operand is used, the LANG operand must 
also be used. The default is HLLTR=NO. 

COBOL: This operand is used to indicate which ANS COBOL compilers are 
to be used to compile user-written application programs. COBOL=V2 
indicates that the ANS COBOL Version 2 Compiler (360N-CB-482 for DOS, 
360S-CB-5U5 for OS) is to be used; C0B0L=V3 indicates that the ANS 
COBOL Version 3 Compiler (5736-CB2 for DOS, 5734-CB1 for OS) is to be 
used; COBOL=V4 indicates that the ANS COBOL Version 4 Compiler 
(5734-CB2) for OS is to be used. The SUBSET parameter indicates that 
the DOS Subset Compiler (5736-CB1) is to be used. If this operand is 
used, LANG=COBOL must also be specified. The default is COBOL=V3. 

XFETCH: This operand is used to generate linkage to a user-written 
exit routine at the point in Program Control following the loading of 
the requested program. For further information concerning user exits, 
see the section "Creating User Exits for CICS Management Programs". 

SUFFIX: This operand is used to provide a two-character alphameric 
suffix for the Program Control program being assembled. If this operand 
is omitted, a suffix is not provided. 
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PROGRAM INTERRUPT CONTROL PROGRAM (PIP) 

The Program Interrupt Control program is a generalized program 
interrupt handler that is given control by the operating system via 
the STXIT (DOS) or SPIE (OS) macro instruction. This program is 
reguired under CICS/OS if the runaway task control feature of Interval 
Control is to be supported. 

The system generation macro instruction necessary to generate the 
Program Interrupt program is: 

DFHSG PROGRAM=PlP, * 

SUFFIX=program suffix 

PROGRAM: The PR0GRAM=PIP operand is used to indicate that the Program 
Interrupt program is to be generated. 

SUFFIX: This operand is used to provide a two-character alphameric 
suffix (other than •NO 1 which is reserved) for the Program Interrupt 
program being assembled. If this operand is omitted, a suffix is not 
provided. 

INTERVAL CONTROL PROGRAM (ICP) 

The system generation macro instruction necessary to generate the 
Interval Control program is as follows: 

DFHSG PROGRAM=ICP, * 

RUNAWAY=YES r * 

ICPTIME=YES, * 

ICPAUTO=YES, * 

ICPSYNC=YES, * 

SUFFIX=program suffix, * 

XTYPREQ=symbolic name, * 

XICEEXP=symbolic name, * 
DUMMY=YES 

Unless otherwise indicated, the omission of an operand results in 
the corresponding function not being included. 

PROGRAM: The PROGRAM=ICP operand indicates that the Interval Control 
program is to be generated. 

If the TIMECTL=NO operand was included in the DFHSG TYPE=INITIAL 
macro instruction, only a dummy Interval Control program is generated. 
If the TIMECTL=NO operand was not included, the remaining operands of 
the DFHSG PROGRAM=ICP macro instruction are applicable and must be 
compatible with the corresponding operands included in the DFHSG 
PROGRAM=KCP macro instruction. 

RUNAWAY: The RUNAWAY=YES operand indicates that the optional runaway 
task control feature of Interval Control is to be included in CICS. 
Note that the Program Interrupt Control program (PIP) is used to support 
this feature and must be generated if the RUNAWAY=YES operand is used 
under CICS/OS. 

ICPTIME: The ICPTIME=YES operand indicates that the optional 
time-of-day feature of Interval Control is to be included in CICS. 
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Note that this operand must be used unless TIMECTL=NO was specified in 
the DFHSG TYPE=INITIAL macro instruction. 

ICPAUTO: The ICPAUTO=YES operand indicates that the optional 
"time-ordered" automatic task initiation feature of Interval Control 
is to be included in CICS. This feature allows tasks to be 
automatically initiated by CICS at a specified time of day or after a 
specified interval of time has elapsed. Note that the Temporary Storage 
Control program (TSP) is used to support this feature and must be 
generated if the ICPA0TO=YES operand is used. Either this operand or 
ICPSYNC=YES operand must be used unless TIMECTL=NO was specified in 
the DFHSG TYPE=INITIAL macro instruction. This feature is used by 
application programmers using the DFHIC macro instruction. 

ICPSYNC: The ICPSYNC=YES operand indicates that the optional task 
synchronization feature of Interval Control is to be included in CICS. 
This feature allows tasks to be synchronized with a specified time of 
day or with a specified interval of time. Either this operand or the 
ICPAUTO-YES operand must be used unless TIMECTL=NO was specified in 
the DFHSG TYPE=INITIAL macro instruction. 

SUFFIX: This operand is used to provide a two-character alphameric 
suffix (other than •NO' or • DY* which are reserved) for the Interval 
Control program being generated. If this operand is omitted, a suffix 
is not provided. 

XTYPEEQ: This operand is used to generate linkage to a user-written 
exit routine at the entry point of Interval Control. For further 
information concerning user exits, see the section "Creating User Exits 
for CICS Management Programs". 

XICEEXP: This operand is used to allow the Interval Control program 
to generate linkage to a user-written exit routine when an Interval 
Control Element (ICE) has expired. For further information concerning 
user exits, see the section "Creating User Exits for CICS Management 
Programs". 

DUMMY: The DUMMY=YES operand is used to specify that a dummy Interval 
Control program is to be generated. If this operand is used, a 'DY' 
suffix is automatically generated for the dummy program; any use of 
the SUFFIX operand is ignored. 

This operand is used in lieu of the DFHSG PROGBAM=CSD macro 
instruction to selectively generate a dummy Interval Control program. 
Any other operands which may have been included in the DFHSG PROGRAM=ICP 
macro instruction are ignored. 
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DUMP CONTROL PROGRAM (DCP) 

The system generation macro instruction necessary to generate the 
Dump Control program is as follows: 

DFHS6 PROGRAM=DCP, * 

DEVICE=TAPE, 2311, 2314, 3330, * 

DEVADDR=nnn, * 

CICSDMP-YES, * 

SUFFIX=program suffix, * 
DOMMY=YES 

Unless otherwise indicated, the omission of an operand results in 
the corresponding function not being included. 

PROGRAM: The Program=DCP operand indicates that the Dump Control 
program is to be generated. 

DEVICE: Applicable only to the CICS/DOS systems, this operand is used 
to specify the type of output device. If this operand is omitted, 
DEVICE=TAPE is assumed. 

A particular Dump Control program in the CICS/DOS systems will 
support only one type of output device. If it is desired that different 
device types be used on different runs, more than one Dump Control 
program must be generated using the SUFFIX operand. 

DEVADDR: If the DEVICE=TAPE operand is used, the DEVADDR=nnn operand 
must be used to specify the DOS device address to be assigned for the 
tape drive. It should be a three-digit decimal number with leading 
zeros, if necessary. For example, if SYS008 is the device address to 
be used, DEVADDR-008 must be specified. If the DEVICE=2311 operand or 
the DEVICE=2314 operand is used, the DEVADDR value is picked up from 
the label information supplied for the Dump Control data set. This 
operand is applicable only to the CICS/DOS systems. 

CICSDMP: The CICSDMP=YES operand is used to specify that the optional 
feature of dumping CICS management programs and tables is to be 
generated. 

SUFFIX: This operand is used to provide a two-character alphameric 
suffix (other than •NO 1 or » DY* which are reserved) for the Dump Control 
program being assembled. If this operand is omitted, a suffix is not 
provided. 

DUMMY: The DUMMY=YES operand is used to specify that a dummy Dump 
Control program is to be generated. If this operand is used, a 'DY* 
suffix is automatically generated for the dummy program; any use of 
the SUFFIX operand is ignored. 

This operand is used in lieu of the DFHSG PROGRAM-CSD macro 
instruction to selectively generate a dummy Dump Control program. Any 
other operands which may have been included in the DFHSG PROGRAM^DCP 
macro instruction are ignored. 
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TERMINAL CONTROL PROGRAM (TCP) 

The system generation macro instruction necessary to generate the 
Terminal Control program is as follows: 

DFHSG PROGRAM=TCP, * 

ACCMETH=(BTAM,BSAM,SAM,BGAM,TCAM) , * 

DEVICE=(™03, 1404, 1442, 1443, 1445, 2311, 2314, 3330, * 

2501, 2520, 2540, CRLP,DASD, DISK, TAPE) , * 

BTAMDEV=(1030, 1050, 1050D, 1053, 1130, 1130D, 2020, 2020D, * 

2260, L2260,2265, 2740, 2740D, 2740-2, 2741C, * 
274 1E,2741DC, 2741 DE, 2760, 2770, 2770D, 2780, 2780D, * 

2980/1, 2980/2, 2980/4, 3275, 3277, L3277, 3284, * 
L3284, 3 286, L3286,3735D, 7770, SYS/3, SYS/3D, SYS/7, * 

SYS/7D,S/360,S/360D,S/370,S/370D,TWX,BISYNC) , * 

FEATURE= (AUTOANSW,AUTOPOLL,BUFFRECV,PSEUDOBIN) , * 
ANSWRBK=(EXIDVER, TERMINAL, AUTOMATIC, 7770TERM,7770NULL) , * 

INITRL=YES, * 

LOCKF=YES, * 

WRAPLST=YES, * 

BSC0DE= (EBCDIC, ASCII, TRANSCODE) , * 

AUTOTRN=YES, * 

UCTRAN=NO, (EBCDIC, ASCII) , * 

COMPAT=NO, (FORMAT, FULLBUF) , * 

FMT2260=(6X40, 12X40, 12X80, 15X64) , * 

FMT3270=(12X40, 24X80) , * 

SMI=user character, * 

TAB=YES,NO, * 

CONVTAB= (ABB, ABC) , * 

XATTACH=symbolic name, * 

XOUTPUT=symbolic name, * 

XINPOT=symbolic name, * 

XTCMIN=symbolic name, * 

XTCMOUT=symbolic name, * 

TCM3270=YES, * 

TCM7770=YES, * 

BMS=YES,NO, * 
SUFFIX=program suffix 

Unless otherwise indicated, the omission of an operand results in 
the corresponding function not being included. 

PROGRAM: The PROGRAM=TCP operand indicates that the Terminal Control 
program is to be generated. 

ACCMETH: This operand identifies the access methods to be used in the 
terminal environment. One or more of the following keyword parameters 
must be specified: 

OTHER OPERAND REQUIRED 

Basic Telecommunication Access Method BTAMDEV 
Basic Seguential Access Method DEVICE 

Sequential Access Method DEVICE 

Graphics Access Method 
Telecommunication Access Method 

BGAM and TCAM are applicable only to the CICS/OS system. BGAM causes 
support for local 2260»s to be generated. If TCAM is specified, CICS 
support for TCAM (360S-CQ-548) is generated. SAM and BSAM are 
functionally synonymous in CICS and can be used interchangeably. Only 
unblocked data sets can be used with SAM or BSAM. 
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In the generation of a TCAM-only Terminal Control Program, the 
following operands do not apply: DEVICE, BTAMDEV, FEATURE, ANSWRBK, 
INITRL, LOCKF, WRAPLST, BSCODE, UCTRAN=ASCII, CONVTAB, XOUTPUT, XINPUT. 

DEVICE: This operand identifies the direct access or sequential devices 
that are to be used in the terminal environment. This operand must be 
used if ACCMETH=SAM or ACCMETH=BSAM is specified. For direct access 
devices, specify either the device type or the generic parameter DASD 
or DISK. 

BTAMDEV: This operand identifies the BTAM device types and must be 
present if ACCMETH=BTAM is specified. The applicable keyword parameters 
are: 
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1030 Data Collection System 

1050 Data Communication System 

10 50 Data Communication System (dial-up) 

1053 Printer on a local/remote 2848 Display Control 

1130 Computing System 

1130 Computing System (dial-up) 

System/360 Model 20 

System/360 Model 20 (dial-up) 

2260 Display Station (remote) 

2260 Display Station (local) 

2265 Display Station 

2740 Communication Terminal Models 1 and 2 

2740 Communication Terminal Models 1 and 2 (dial-up) 

2740 Communication Terminal Model 2 (2740 must also be 
specified) 

2741 Communication Terminal with correspondence code 
2741 Communication Terminal with PTTC/EBCD code 
2741 Communication Terminal with correspondence code 
(dial-up) 

2741 Communication Terminal with PTTC/EBCD code (dial-up) 

2760 Optical Image Unit 

2770 Data Communication System 

2770 Data Communication System (dial-up) 

2780 Data Transmission Terminal 

2780 Data Transmission Terminal (dial-up) 

2980 General Banking Terminal System Model 1 

2980 General Banking Terminal System Model 2 

2980 General Banking Terminal System Model 4 

3275 Display Station (remote) 

3277 Display Station (remote) 

3277 Display Station (local) 

3284 Printer on a remote 3271 Control Unit 

3284 Printer on a local 3272 Control Unit 

3286 Printer on a remote 3271 Control Unit 

3286 Printer on a local 3272 Control Unit 

3735 Programmable Buffered Terminal (dial-up) 

7770 Audio Response Unit Model 3 

System/3 Models 6 and 10 

System/3 Models 6 and 10 (dial-up) 

System/7 

System/7 (dial-up) 

System/360 

System/360 (dial-up) 

System/370 

System/370 (dial-up) 

Common Carrier Teletypewriter Exchange Terminal 

(Model 33/35) 

Binary synchronous devices (for CICS/OS-STANDARD V1 

compatibility) 
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The L2260 parameter is applicable only to the CICS/DOS systems. The 
BISYNC parameter includes 1130, System/360 Model 20, and System/360 
Model 25 or higher. One or more parameters can be included in the 
BTAMDEV operand. 

Individual device type parameters are provided for the BTAMDEV 
operand so that system generation input is self documenting. If the 
parameter length for this operand exceeds assembler limit of 255 
characters for the particular system being generated, synonymous 
parameters can be omitted. Specifying any one of the parameters from 
a group produces supportive code for all devices in the group. These 
groups are: 

1. 2020, SYS/3, S/360,S/370, 1130, BISYNC 

2. 2020D,SYS/3D,S/360D,S/370D,1130D 

3. 3275,3277,3284,3286 

4. L3277,L3284,L3286 

5. 1053,2260,2265 

Note: When binary synchronous communication lines are part of the 
user's configuration, it is possible for these communication 
lines to time out if control is not returned to the terminal 
before a timeout can occur. The user can alleviate this 
condition in either of two ways: (1) by having the application 
program issue a CICS Task Control WAIT macro instruction to 
voluntarily relinquish control, or (2) by setting the runaway 
task time interval to a value that causes the long-running task 
to be terminated before the line timeout can occur. 

FEATURE: This operand is used to specify the special features present 
in the terminal environment. The applicable keyword parameters are: 

Switched lines 

Automatic polling feature required for multipoint 
binary synchronous communication terminals 
Buffer feature support for 2740 Model 2 
Pseudo-binary transmission code for System/7 

One or more parameters can be included in the FEATURE operand. 

ANSWRBK: This operand is used to specify the type of terminal 
identification; it must be used if FEATURE=AUTOANSW is specified. The 
parameters of this operand are not mutually exclusive. 

ANSWRBK=EXIDVER specifies that BTAM-expanded ID verification is to 
be employed to identify those terminals which transmit unique 
identification sequences. ANSWRBK=EXIDVER must be specified if 
BTAMDEV=3735D. 

ANSWRBK=TERMINAL specifies that the operator will supply the 
identification for switched lines. 

ANSWRBK=AUTOMATIC specifies that automatic terminal identification 
is to be sent by the terminal. 

For terminals that communicate with a 7770 Audio Response Unit, the 
applicable keyword parameters are 7770TERM and 7770NULL. 
ANSWRBK=7770TERM specifies that the operator will supply the terminal 
identification. ANSWRBK=7770NULL specifies that no terminal 
identification is to be sent by either the terminal or operator; 
instead, the Terminal Control program will connect the line to the next 
available terminal in the terminal pool. The default is 
ANSWRBK=7770TERM, providing BTAMDEV=7770 has also been specified. 
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Note: The ANSWRBK operand must include all keyword parameters for 

which the corresponding parameter is to be included in the DFHTCT 
TYPE=LINE specification during Terminal Control Table 
preparation. 

INITRL: Applicable only to the CICS/OS-STANDARD system, the INITRL=YES 
operand (initial read lock) is used to indicate that all reads from 
other than an application program are with the keyboard lock option. 
The FEATURE=KBRDLOCK operand must be included in the DFHTCT TYPE=LINE 
macro instruction to have the keyboard lock feature operative for that 
line. This operand applies to the 2848 Model 21 and 22 with the 
optional keyboard lock feature. 

LOCKF: The LOCKF=YES operand is used to indicate that the optional 
keyboard lock feature, supporting the 2848 models 21 and 22, is to be 
included in CICS. The FEATURE=KBRDLOCK operand must be included in 
the DFHTCT TYPE=LINE macro instruction to have the keyboard lock feature 
operative for that line. For the CICS/DOS systems, if LOCKF=YES is 
specified and if FEATURE=KBRDLOCK is included in the DFHTCT TYPE=LINE 
macro instruction, the keyboard is locked on all reads including the 
initial read. 

WRAPLST: The WRAPLST=YES operand is used to specify that the optional 
wrap list feature is to be included in CICS. The list to be constructed 
is a wraparound polling list for a nonswitched line. 

BSCODE: This operand is used to indicate what types of binary 
synchronous communication code are to be supported. The default is 
BSCODE= (EBCDIC, ASCII, TRANSCODE) . 

AUTOTRN: The AUTOTRN=YES operand is used to specify that the optional 
automatic transaction initiation feature is to be included in CICS. 
Automatic transaction initiation is specified by the TRANSID operand 
of the DFHDCT macro instruction. 

UCTRAN; This operand is used to generate support for the translation 
of lowercase data to uppercase in 3270 input data streams. If 0CTRAN=N0 
is specified, uppercase translation support for the 3270 is not 
generated. The default is UCTRAN=NO. 

If BSCODE=EBCDIC and/or CONVTAB=EBCDIC have been specified for 
particular lines, UCTRAN=EBCDIC specifies that support is to be 
generated for local and remote 3270 , s on those lines. If BSCODE=ASCII 
and/or CONVTAB=ASCII have been specified for particular lines, 
UCTRAN=ASCII indicates that support is to be generated for remote 3270's 
on those lines. 

Uppercase translation for the 3270 is performed only on input data 
streams received from those 3270* s for which FEATORE=UCTRAN was 
specified during preparation of the Terminal Control Table. 

COMPAT: This operand is used to generate 2260-compatibility support 
for the 3270 Information Display System. Such support allows the user 
to run his currently operational 2260-based transactions from a 3270. 
If COMPAT=NO is specified, 2260-compatibility support for the 3270 is 
not generated. The default is COMPAT=NO. 
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Two modes of compatibility operation are provided: FORMAT and 
FULLBUF. Either or both may be specified with a single use of the 
COMPAT operand. If COMPAT is specified, then FMT2260 and FMT3270 must 
be used to specify the screen formats. 

COMPAT=FORMAT indicates that FORMAT compatibility mode is to be 
generated. FORMAT mode takes full advantage of the 3270 formatting 
and data compression facilities, and is the preferred method of 
2260-compatibility operation, particularly for the operation of remote 
3270's. 

COMPAT=FULLBUF indicates that FULLBUF compatibility mode is to be 
generated. FULLBUF mode does not use the 3270 data compression 
facilities and must therefore be used when all lines of input data are 
desired. 

Note.! If a 480-character 2260 is mapped onto a 480-character 3270, 

use of FORMAT mode causes the loss of the last character of each 
2260 output line. Use of FULLBUF mode limits the data loss to 
the last character position of the last line but at the expense 
of transferring a full 480 characters for each interaction 
involving a data entry key. 

FMT2260: This operand is used to specify the various 2260 screen 
formats to be simulated for 2260-based transactions on the 3270 
Information Display System. The applicable keyword parameters are: 

1. 6X40 240-character 2260 Display Station 

2. 12X40 480-character 2260 Display Station 

3. 12X80 960-character 2260 Display Station or 12-row, 80-column 

format for the 2265 Display Station 

4. 15X64 15-row, 64-column format for the 2265 Display Station 

FMT3270: This operand is used to specify the 3270 screen formats on 
which 2260 screen formats are to be simulated for 2260-based 
transactions. The applicable keyword parameters are: 

1. 12X40 480-character 3275/3277 Display Station 

2. 24X80 1920-character 3275/3277 Display Station 

SMI: This operand is used to specify the character that is to represent 
the start of message indicator (SMI) in all messages to and from the 
3270 operating in 2260 compatibility mode. This character is generated 
as a X'4A' and must be a valid alphameric displayable character. If 
the SMI character is contained in an output data stream, its display 
is dependent upon the language feature specified for the 3270. Whatever 
character is chosen, it remains the same for all transactions. The 
default is SMI=*. 

TAB: TAB=YES must be specified if any of the 2260-compatible 3270 
transactions make use of the 2260 tab feature. In this case, all colon 
(:) characters are honored as 2260 tab characters when included in the 
output data stream. The default is TAB=NO. 

GONVTAB: This operand is used to specify the type of conversion to be 
performed on the data received from the 7770 Audio Response Unit. 
CONVTAB=ABB specifies conversion from ABB 1 transmission code; 
CONVTAB=ABC specifies conversion from ABC transmission code. Either 
or both may be specified with a single use of the CONVTAB operand. If 
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this operand is used, ACCMETH=BTAM and BTAMDEV=7770 must also be 
specified. The default is CONVTAB= (ABB, ABC) . 

XATTACH: This operand is used to generate linkage in the Terminal 
Control program to a user-written exit routine. The linkage is 
generated at the point prior to issuing a Task Control ATTACH for a 
transaction identification which is received in response to polling. 
For further information concerning user exits, see the section "Creating 
User Exits for CICS Management Programs" or the section "CICS/TCAM 
Interface Considerations". 

XOUTPUT: This operand is used to generate linkage in the Terminal 
Control program to a user-written exit routine. The linkage is 
generated for output events at the point prior to translating or framing 
output data. For further information concerning user exits, see the 
section "Creating User Exits for CICS Management Programs". 

XINPUT: This operand is used to generate linkage in the Terminal 
Control program to a user-written exit routine. The linkage is 
generated at the point following completion of any input event. For 
further information concerning user exits, see the section "Creating 
User Exits for CICS Management Programs". 

XTCMIN: Applicable only to the CICS/OS system, this operand is used 
to generate linkage in the Terminal Control program TCAM module to a 
user written exit routine. The linkage is generated following 
completion of any input event. For further information concerning TCAM 
user exits, see the section "CICS/TCAM Interface Considerations". 

XTCMOUT: Applicable only to the CICS/OS system, this operand is used 
to generate linkage in the Terminal Control program TCAM module to a 
user written exit routine. The linkage is generated for output events 
at the point prior to placing data on the output queue. For further 
information concerning TCAM user exits, see the section "CICS/TCAM 
Interface Considerations". 

TCM3270: Applicable only to the CICS/OS system, this operand is 
required if TCAM support is to include the 3270 Information Display 
System. 

TCM7770: Applicable only to the CICS/OS system, this operand is 
required if TCAM support is to include the 7770 Audio Response Unit. 

BMS: This operand is used to generate basic mapping support (BMS) for 
the 3270 Information Display System. If BMS=YES is specified, a 
corresponding entry (DFHBMSMM) must be included during preparation of 
the Processing Program Table (PPT) . The default is BMS=NO. 

SUFFIX: This operand is used to provide a two-character alphameric 
suffix for the Terminal Control program being assembled. If this 
operand is omitted, a suffix is not provided. 
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FILE CONTROL PROGRAM (FCP) 

The system generation macro instruction necessary to generate the 
File Control program is as follows: 

DFHSG PROGRAM=FCP, * 

CONSEC-YES, * 

FILSERV=s(INDA,INIS,DAUPD,ISUPD,DAADD,ISADD,INDIRACC, * 
EXCTL,INSEG,OUTSEG, DABLKNG,VLR, HEXAD,DECAD, ACTAD, * 

IVBR, LOCATE, IBROWSE,DBROWSE) , * 

SUFFlX-program suffix, * 

XTYPREQ-symbolic name, * 

XOUTPUT=symbolic name, * 

XINPUT^symbolic name, * 

XINPUTC=symbolic name, * 
DUMMY=YES 

Unless otherwise indicated, the omission of an operand results in 
the corresponding function not being included. 

PROGRAM: The PROGRAM=FCP operand indicates that the File Control 
program is to be generated. 

CONSEC: This operand is effective only in the CICS/DOS-ENTRY system; 
it causes logic to be generated in File Control that limits the number 
of consecutive I/O events initiated by File Control that can occur on 
behalf of a given task. When the limit (contained in the CSA at 
CSAKCCDL) is reached, the task is rolled out by Task Control. This 
facility helps protect CICS from being "seized" by a single task. This 
consectuive dispatch limit is specified in the System Initialization 
Table. 

FILSERV: This operand is used to specify which of the file services 
are to be generated into the File Control program. The applicable 
keyword parameters are as follows: 

Input DAM 

Input ISAM 

Update DAM 

Update ISAM 

Add DAM 

Add ISAM 

Indirect accessing 

Exclusive control (requires Task Control enqueue 

feature) 

Input segmenting 

Output segmenting 

Direct access blocking 

Variable length-records 

Hexadecimal relative track addressing (DAM) 

Zoned decimal relative track addressing (DAM) 

Actual track addressing (DAM) 

ISAM variable-length records (CICS/DOS only) 

Dynamic open/close/locate 

ISAM sequential record retrieval 

DAM sequential record retrieval 

Any number of these keyword parameters can be included in the FILSERV 
operand or CSMT File Service functions. 

Notes : Use of the file browse option under CICS/OS requires that the 
user create the CVT macro and place it in SYS1.MACLIB. For 
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guidance in creating the CVT macro, see the CICS/OS Operations 
Guide. 

LOCATE must be specified when DFHOCP is generated. 

SUFFIX: This operand is used to provide a two-character alphameric 
suffix (other than • DY* which is reserved) for the File Control program 
being assembled. If this operand is omitted, a suffix is not provided. 

XTYPREQ: This operand is used to generate linkage in the File Control 
program to a user-written exit routine. The linkage is provided prior 
to determining what type of request for file services was issued. For 
further information concerning user exits, see the section "Creating 
User Exits for CICS Management Programs". 

XOUTPUT: This operand is used to generate linkage in the File Control 
program to a user-written exit routine. The linkage is provided prior 
to writing data in response to an output request. For further 
information concerning user exits, see the section "Creating User Exits 
for CICS Management Programs". 

XINPUT: This operand is used to generate linkage in the File Control 
program to a user-written exit routine. The linkage is provided after 
the File Control Table (FCT) is searched in response to an input 
request. For further information concerning user exits, see the section 
"Creating User Exits for CICS Management Programs". 

XINPUTC: This operand is used to generate linkage in the File Control 
program to a user-written exit routine. The linkage is provided upon 
completion of an input event but prior to deblocking requested input 
records. For further information concerning user exits, see the section 
"Creating User Exits for CICS Management Programs". 

DUMMY: The DUMMY=YES operand is used to specify that a dummy File 
Control program is to be generated. If this operand is used, a •DY I 
suffix is automatically generated for the dummy program; any use of 
the SUFFIX operand is ignored. 

This operand is used in lieu of the DFHSG PROGRAM=CSD macro 
instruction to selectively generate a dummy File Control program. Any 
other operands which may have been included in the DFHSG PROGRAM-FCP 
macro instruction are ignored. 

TRANSIENT DATA CONTROL PROGRAM (TDP) 

The system generation macro instruction necessary to generate the 
Transient Data Control program is as follows: 

DFHSG PROGRAM=TDP, * 

INTRA=YES,TRANSINIT, * 

EXTRA= (ACQUISITION, DISPOSITION) , * 

SUFFIX=program suffix, * 

DEVICE=2311, 2314, 3330, * 

XTYPREQ=symbolic name, * 

XOUTPUT=symbolic name, * 

XINPUT=symbolic name, * 
DUMMY=YES 
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Unless otherwise indicated, the omission of an operand results in 
the corresponding function not being included. 

PROGRAM: The PROGRAM=TDP operand indicates that the Transient Data 
Control program is to be generated. 

INTRA: The INTRA=YES operand specifies that intrapartition data sets 
are to be used. The INTRA=TRANSINIT operand is used to specify that 
intrapartition data sets are to be used and that the automatic task 
initiation feature is also to be included. For further information 
concerning intrapartition data sets, refer to Transient Data Services 
section of the Application Pr ogramme r's Reference Manual SH20-22iZ* 

EXTRA: This operand specifies that extrapartition data sets are to be 
used. EXTRA=ACQUISITION indicates input from an extrapartion data set. 
EXTRA=DISP0SITI0N indicates output to an extrapartition data set. One 
or both of these parameters can be included in this operand. For 
further information concerning extrapartition data sets, refer to 
Transient Data Services section of the Application Prog ramm er's Reference 
Manual SH20-1047. 

SUFFIX: This operand is used to provide a two-character suffix (other 
than ■ DY' which is reserved) for the Transient Data Control program 
being assembled. If this operand omitted, a suffix is not provided. 

DEVICE: Applicable only to the CICS/DOS systems, this operand is used 
to specify the type of device on which the intrapartition data set 
resides. The default is DEVICE=2311. 

XTYPREQ: This operand is used to generate linkage in the Transient 
Data Control program to a user-written exit routine. The linkage is 
provided prior to determining what type of request for Transient Data 
services was issued. For further information concerning user exits, 
see the section "Creating User Exits for CICS Management Programs". 

XOUTPUT: This operand is used to generate linkage in the Transient 
Data Control program to a user-written exit routine. The linkage is 
provided after locating the appropriate entry in the Destination Control 
Table (DCT) but prior to writing data in response to an output request. 
For further information concerning user exits, see the section "Creating 
User Exits for CICS Management Programs". 

XINPUT: This operand is used to generate linkage in the Transient Data 
Control program to a user-written exit routine. The linkage is provided 
after acquiring data in response to an input request. For further 
information concerning user exits, see the section "Creating User Exits 
for CICS Management Programs". 

DUMMY: The DUMMY=YES operand is used to specify that a dummy Transient 
Data Control program is to be generated. If this operand is used, a 
■DYV suffix is automatically generated for the dummy program; any use 
of the SUFFIX operand is ignored. 

This operand is used in lieu of the DFHSG PROGRAM=CSD macro 
instruction to selectively generate a dummy Transient Data Control 
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program. Any other operands which may have been included in the DFHSG 
PROGRAM=TDP macro instruction are ignored. 

TEMPORARY STORAGE CONTROL PROGRAM (TSP) 

The system generation macro instruction necessary to generate the 
Temporary Storage Control program is as follows: 

DFHSG PROGRAM=TSP, * 

DEVICE=2311, 2314, 3330, * 

SUFFIX=program suffix, * 

VIRTUAL=VIRTUAL,REAL, * 

XTYPREQ=symbolic name, * 

XOUTPUT=symbolic name, * 

XINPUT=symbolic name, * 
DUMMY=YES 

Unless otherwise indicated, the omission of an operand results in 
the corresponding function not being included. 

PROGRAM: The PROGRAM=TSP operand indicates that the Temporary Storage 
Control program is to be generated. 

DEVICE: Applicable only to the CICS/DOS systems, this operand is used 
to specify the type of device on which the temporary storage data set 
resides. This operand is required in the CICS/DOS-ENTRY system; it 
can be omitted in the CICS/DOS-STANDARD system if the temporary storage 
data set resides in main storage. The default is DEVICE=2311. 

SUFFIX: This operand is used to provide a two-character suffix (other 
than •NO 1 or • DY • which are reserved) for the Temporary Storage program 
being assembled. If this operand is omitted, a suffix is not provided. 

VIRTUAL: This operand specifies whether Temporary Storage is to be 
run in a real or virtual environment. Specification of VIRTUAL for 
this operand generates a Temporary Storage program capable of running 
in a V=V or V=R environment, but consumes a greater amount of address 
space. Specifying REAL generates a Temporary Storage program capable 
of running only in a V=R environment. 

Note: This operand is valid only for CICS/OS STANDARD Version 2.3 with 
the fix for APAR No. P10780 applied or for later releases. 

XTYPREQ: This operand is used to generate linkage in the Temporary 
Storage Control program to a user-written exit routine. The linkage 
is provided prior to determining what type of request for Temporary 
Storage services was issued. For further information concerning user 
exits, see the section "Creating User Exits for CICS Management 
Programs". 

XOUTPUT: This operand is used to generate linkage in the Temporary 
Storage Control program to a user-written exit routine. The linkage 
is provided prior to writing data in response to an output request. 
For further information concerning user exits, see the section "Creating 
User Exits for CICS Management Programs". 
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XINPUT: This operand is used to generate linkage in the Temporary 
Storage Control program to a user-written exit routine. The linkage 
is provided prior to returning control to the application program after 
servicing an input reguest. For further information concerning user 
exits, see the section "Creating User Exits for CICS Management 
Programs". 

DUMMY: The DUMMY=YES operand is used to specify that a dummy Temporary 
Storage program is to be generated. If this operand is used, a •DY 1 
suffix is automatically generated for the dummy program; any use of 
the SUFFIX operand is ignored. 

This operand is used in lieu of the DFHSG PROGEAM=CSD macro 
instruction to selectively generate a dummy Temporary Storage Control 
program. Any other operands which may have been included in the DFHSG 
PROGRAM=TSP macro instruction are ignored. 

COMMON SYSTEM ARIA (CSA) 

The system generation macro instruction necessary to generate the 
Common System Area is as follows: 

DFHSG PROGRAM=CSA, * 

WRKAREA=number, * 

SUFFIX=program suffix 

In addition to generating the CSA, the execution of this macro 
instruction causes the assembly of Terminal Control's TCA, Task 
Control's TCA, and, in the CICS/DOS systems, a Write to Operator (WTO) 
routine. In the CICS/OS system, a dummy CSA is also generated. 

PROGRAM: The PROGRAM=CSA operand indicates that the Common System Area 
is to be generated. 

WRKAREA: This operand is used to specify the number of bytes to be 
allocated to the common work area portion of the CSA. This area is 
initially set to binary zeros and is available to all programs. If 
the WRKAREA operand is omitted, the size of the work area defaults to 
512. The maximum size for the work area is 3584 bytes. 

SUFFIX: This operand is used to provide a two-character suffix for 
the CSA being generated. If this operand is omitted, a suffix is not 
provided. 

MASTER TERMINAL PROGRAM (MTP) 

The system generation macro instruction necessary to generate the 
Master Terminal program is: 

DFHSG PROGRAM=MTP, * 

TLT=YES,NO 

PROGRAM: The PROGRAM=MTP operand indicates that the Master Terminal 
program is to be generated. 

TLT: The TLT=NO operand indicates that the user does not desire to 
use the Master Terminal program to load Terminal list Tables during 
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real-time execution of CICS. TLT=YES indicates that the Master Terminal 
program will be used to load a Terminal List Table to change the status 
of a class of terminals and/or ensure that a supervisory terminal 
operator can change the status of only those terminals under his 
control. The default is TLT=YES. 

DYNAMIC OPEN/CLOSE PROGRAM (OCP) 

The system generation macro instruction necessary to generate the 
Dynamic Open/Close program is: 

DFHSG PROGRAM=OCP 

This macro instruction must be issued if the Dynamic Open/Close program 
is to be used either through the Master Terminal facility or in response 
to a DFHOC request in an application program. Whenever this program 
is used, FCP must be generated with FILSERV= (. . . , LOCATE) . 

GRAPHIC ATTENTION PROGRAM (GAP) 

The system generation macro instruction necessary to generate the 
Graphic Attention program is: 

DFHSG PROGRAM=GAP 

This macro instruction is effective only in the CICS/OS-STANDARD system 
and is used to generate support for the local 2260. 

HI GH-LEV EL LANGUAGE SUPPORT GROUP (HLL) 

The system generation macro instruction necessary to generate the 
High-Level Language Support group is: 

DFHSG PROGRAM=HLL, * 

LANG= (COBOL , PL/I) , * 

PL1=(0,F) 

The support programs generated in response to this macro instruction 
are as follows: 

1. CICS preprocessor program (DFHPRPR) - for either or both 
languages 

2. Entry Interface program (DFHPL1I) for PL/I F and/or for PL/I 
Optimizer (DFHPL10I) 

3. PL/I Interface program (DFHSAP) for PL/I F and/or for PL/I 
Optimizer (DFHPL10I) 

PROGRAM: The PROGRAM=HLL operand indicates that the High-Level Language 
Support group is to be generated. 

LANG: This operand is used to identify the languages for which support 
is to be generated. 

PL1: Applicable only to the CICS/OS system, this operand is used to 
identify the PL/I compilers for which support is to be generated. The 
default is PL1=F. If both compilers are to be used, PL1=(0,F) must be 
specified. 
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TERMINAL DEPENDENT CONTROL PROGRAM (TDCP) 

The system generation macro instruction necessary to generate the 
Terminal Dependent Control program is: 

DFHSG PROGRAM=DDM 

This macro instruction must be issued when using 1030 terminals. 

ASYNCHRONOUS TRANSACTION PROCESSING GROUP (ATP) 

The system generation macro instruction necessary to generate the 
Asynchronous Transaction Processing group is: 

DFHSG PROGRAM=ATP, * 

INBUFF=number, * 

OUTBUFF=number 

The following programs are generated in response to this macro 
instruction: 

1. Asynchronous Transaction Control program (DFHATP) 

2. Asynchronous Transaction Input Processing programs 
(DFHRD1 and DFHRD2) 

3. Asynchronous Transaction Output Processing programs 
(DFHWT1 and DFHWT2) 

4. Asynchronous Queue Purge program (DFHAQP) 

Note that this macro instruction is effective only if ATP=YES was 
included in the DFHSG TYPE=INITIAL macro instruction. 

PROGRAM: The PROGRAM=ATP operand indicates that the Asynchronous 
Transaction Processing group is to be generated. 

INBUFF: This operand is used to specify the size (in bytes) of the 
input buffer used by the Asynchronous Transaction Input Processing 
programs. The value specified should not exceed full track capacity 
for the device being used, or, in the case of CICS/OS, should not exceed 
the block size specified on the intrapartition data set data definition 
(DD) card at start-up time. 

OUTBUFF: This operand is used to specify the size (in bytes) of the 
output buffer used by the Asynchronous Transaction Control program. 
The value specified should not exceed full track capacity for the device 
being used, or, in the case of CICS/OS, should not exceed the block 
size specified on the intrapartition data set data definition (DD) card 
at startup time. 

TERMINATION OF CICS/DOS SYSTEM GENEIATION 

Terminating JCL for Stage II is produced in response to the 

DFHSG TYPE=FINAL 

macro instruction. This macro instruction is effective only in the 
CICS/DOS systems and must be the last statement of the CICS/DOS system 
generation input stream preceding the Assembler END card. 
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GENERATION OF CICS/OS DATA LANGUAGE/I FACILITIES 

To provide CICS/OS application programs optional access to the Data 
Language/I (DL/I) facility of the IBM Information Management System 
(IMS/360) , the following steps are necessary: 

1. Generate an IMS/360 Version 2 Data Base System capable of 
executing batch IMS/360 programs. This system must be 
Modification Level 2 or later. 

2. Indicate during generation of CICS that application programs 
can access DL/I. This is done by coding 

DFHSG TYPE=INITIAL,DL1=YES 

3. Generate a System Initialization Table (SIT) which includes 
parameters for the CICS-DL/I interface. Applicable parameters 
are DL1, PSB r BUFPL, PSBPL and DMBPL; these parameters may be 
included or overridden at execution time. 

4. Include the following CICS options during generation of CICS: 

a. Task Control ENQUEUE/DEQUEUE 

b. File Control LOCATE 

c. Interval Control program (ICP) 

5. Generate IMS/360 Control Blocks as detailed below. 

DEFINING PSB»S AND PCB» S 

The CICS-DL/I interface has the following requirements for Program 
Specification Block (PSB) generation: 

1. A special initialization PSB is used by CICS-DL/I Initialization 
to bring the proper DL/I modules into storage. This PSB r called 
the "initialization" PSB is not used by any transaction. Program 
Communication Blocks (PCB's) are defined within the PSB to 
indicate what type of CALL'S and data bases DL/I will be called 
upon to service. The following rules apply. 

a. Define one data base PCB (TYPE=DB) for each of the following 
access methods to be used: HSAM, HDAM. 

b. Define two data base PCB's for the same data base for each 
of the following access methods to be used: HISAM, HIDAM. 
These PCB's will be referred to as a PCB pair. Their 
specification causes BISAM rather than QISAM to be used. 

c. Within each PCB, define PROCOPT (processing options) to 
include all processing options to be performed against all 
the data bases using that access method. That is, if one 
HDAM data base is to be accessed via PROCOPT=GE and another 
via PROCOPT=GRP, the combined PROCOPT to be specified is 
PROCOPT=GRPE. 

d. For each PCB being defined, provide one SENSEG statement. 
For the PCB pairs required for HISAM or HIDAM (see above), 
the SENSEG statements must refer to the same segment type. 
If the use of QISAM is desired in addition to BISAM, provide 
an additional SENSEG statement in one PCB of the £CB pair. 

e. In the PCB statement, specify KEYLEN to be the length of 
the key field defined in the SENSEG statement in (d) above. 
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f . The last statement preceding the END statement in the 
assembly should be written: 

PSBGEN LANG=ASSEM,PSBNAME=psbname 

If DL1=YES is specified during CICS System Initialization, 
the PSB used is named CICS PSB unless overriden in the System 
Initialization Table or by the execution time PSB parameter. 

2. If an application programmer does not name a PSB in the DL/I 
CALL, the PSB used has the name of the program whose name is in 
the Program Control Table (PCT) entry for this transaction. 
Therefore, for all transactions with DL/I CALL*s where the PSB 
name is not specified, there must be a PSB generated with the 
same name as the program name in the PCT entry for the 
transaction. For PL/I programs, specify that the PSB is for 
PL/I. 

3. If an application programmer names a PSB in the DL/I CALL, there 
must be a PSB generated with the name used in that CALL. For 
PL/I programs, specify that the PSB is for PL/I. 

The CICS-DL/I Interface uses the pre-built blocks feature of DL/I. 
After all Program Specification Blocks (PSB^) and Data Base 
Descriptions (DBD's) have been generated, the user must then generate 
Application Control Blocks (ACB's) in the IMS/360 ACB Library for all 
PSB*s to be used. The instructions for this generation are included 
in the IMS/360 Ut ilities Manual. 

DEFINING PSB AND DMB DIRECTORIES DURING CICS GENERATION 

A PSB Directory (PDIR) list and DMB Directory (DDIR) list must be 
built for the CICS-DL/I Interface. Each of these lists is built by a 
separate assembly and link edit. Both lists are then included in the 
link-edit of DFHDLQ as described in the CICS/OS Operations Guide. 

PSB Directory List 

Each PSB excluding the initialization PSB, to be used by transactions 
is defined via the statement: 

label DFHDLPSB PSB=psbname 
The last statement in the assembly preceding the END statement is: 

label DFHDLPSB TYPE=FINAL 
The NAME card for the Linkage Editor is written: 

NAME DFHDLPSB (R) 
DMB Dir ectory List 

Each Data Base Description (DBD) used by the system is defined via 
the statement: 

label DFHDLDBD (INDEX,) DBD=dbdname 

where the positional operand, INDEX, indicates that this is a DFHDLDBD 
statement for the INDEX DBD of a HIDAM data base. 
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The last statement in the assembly preceding the END statement is: 

(label) DFHDLDBD TYPE=FINAL 
The NAME card for the Linkage Editor is written: 

NAME DFHDLDBD (R) 
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SYSTEM TABLE PREPARATION 



CICS is dependent upon user-created system tables which describe 
the user's data base/data communications environment and the treatment 
the user wishes given to the elements of that environment. Contained 
in the system tables is information regarding the user's terminals, 
data sets (permanent and temporary) , programs, and transactions. These 
tables are created independently of system generation. However, they 
are required for the system to be operational. 

CICS is dynamically configured under user control during system 
initialization. The desired system tables are selected by the user, 
based on a standard naming and suffixing convention. Each of the tables 
is created separately and may be recreated at any time prior to system 
initialization. More than one system table of each type can be 
maintained at the same time. This allows the user to maintain special 
tables for testing in addition to the operational tables. 

The system tables are prepared (generated) by assembling the 
appropriate macro instruction and its associated operands using the 
Assembler program. The output of each assembly contains the required 
Linkage Editor control cards. The tables are named in the following 
manner: 

TABLE NAME 

System Initialization Table DFHSITxx 

Terminal Control Table DFHTCTxx 

File Control Table DFHFCTxx 

Destination Control Table DFHDCTxx 

Program Control Table DFHPCTxx 

Processing Program Table DFHPPTxx 

The first six positions are standard for each of the tables. The 
last two positions (xx) may be specified by the user to allow several 
versions of a table to be maintained; any two characters (other than 
•NO 1 ) are valid. The suffix which the user assigns to a table is used 
to determine which version of that table is to be loaded into the system 
during system initialization. 

When generating system tables, the assembly of each table must be 
terminated by an Assembler END statement which includes a mandatory 
label (symbol) of the form DFHxxxBA, where xxx is the three-character 
table designation (for example, END DFHFCTBA terminates the assembly 
of the File Control Table) . 

See the appropriate CICS Operations Guide for details concerning 
the link editing of the tables. 

A detailed description follows of what is required to complete the 
control cards or macro instructions for each of the system tables. 

SYSTEM^ INITIALIZATION TABLE (SIT) 

The initialization of CICS is both flexible and dynamic. The 
flexibility at the time of initialization is provided by the System 
Initialization Table (base name: DFHSIT) . The contents of the DFHSIT 
macro which is assembled as a table supplies the System Initialization 
program with the information to initialize the system to meet the user's 
unique environment. During the initialization process, the user is 
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given an opportunity to dynamically change some of the parameters, as 
reguired. 

The information contained in DFHSIT may be grouped into three 
catagories for purposes of discussion: 

1. Information used to initialize and control system functions (for 
example, storage cushion size, system partition/region exit time 
interval, etc. ) . 

2. Module suffixes used to load the user-specified version of the 
CICS control modules and tables (for example, DFHPCTxx, DFHFCPxx, 
etc.) . 

3. Special information used to control the initialization process. 

The user also has the flexibility of generating several System 

Initialization Tables and selecting the appropriate one at the time of 
initialization. 

The following operands can be included in the DFHSIT macro 
instruction: 

DFHSIT TYPE=CSECT,DSECT, * 

SOFFIX=XX, * 

TRT=decimal value, * 

SCS=decimal value, * 

SP1=decimal value, * 

DVT=2311, 2314, 3330, * 

MSGLVL=0,1, * 

TSBLK=decimal value, * 

ICV=decimal value, * 

ICVS=decimal value, * 

ICVR=decimal value, * 

CDL=decimal value, * 

MXT=decimal value, * 

TCT=xx, * 

PPT=xx, * 

PCT=xx, * 

FCT=xx,NO, * 

DCT=xx,N0, * 

CSA=xx, * 

KCP=xx, * 

SCP=XX, * 

PCP=XX, * 

DCP=xx,NO, * 

ICP=xx,NO, * 

TCP=xx, * 

FCP=XX, * 

TDP=xx, * 

TRP=xx, * 

PIP=xx,NO, * 

TSP=xx,NO, * 

OSCOR=decimal value, * 

PL1=YES,N0, * 

DL1=YES,N0, * 

PSB=name, * 

PSBPL=number, * 

DMBPL=number, * 

BUFPL=number, * 

ATP=YES,N0, * 

ATPMT=number, * 

ATPMB=number, * 
SIM0DS=(A2,B1,C1,C2,C3,D1,E1) or 
(A2,B1,C1,D1,E1) 
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TYPE: Specifies whether a CSECT or DSECT of the System Initialization 
Table is to be generated. If alternate or additional System 
Initialization modules are coded by the user, a DSECT may be required 
to provide symbolic addressability to values in the table. The default 
is TYPE=CSECT. 

SUFFIX: Specifies a two-character alphameric suffix for the System 
Initialization Table being assembled. This suffix, if specified, is 
appended to the standard module name (DFHSIT) and is used to name the 
module on the linkage editor output library. If this operand is 
omitted, a suffix is not provided. 

TRT: Specifies the number of entries that are to be provided in the 
CICS Trace Table. If the user has not generated the Trace facility, 
this operand should be ignored or set to 0. (See the discussion of 
DFHSG TYPE=INITIAL.) If Trace has been generated and this parameter is 
0, a dummy Trace facility is loaded (DFHTRPDY) . The default is TRT=0. 

SCS: Specifies the number of bytes (minimum 20) which are to be 
reserved for the storage cushion. The default is SCS=500. 

SP1: Specifies the number of bytes to be reserved for subpool 1 storage 
in the CICS/DOS-ENTRY system. The default is SP1=0. To arrive at the 
size required, refer to "Storage Estimates and Considerations" in the 
CICS General Information Manual (GH20-1028) . 

DVT: Applicable only to the CICS/DOS systems, this operand specifies 
the device type on which the CICS/DOS system data sets reside. These 
data sets include the following: 

1. CICS Real-Time Relocatable Program Library 

2. CICS Real-Time Pre-Located Program Library (CICS/DOS-ENTRY system 
only) 

3. CICS Transaction Rollout Data Set (CICS/DOS-ENTRY system only) 

Since no default is provided, 2311, 2314 or 3330 must be specified. 

MSGLVL: Specifies a message level of either or 1 which controls the 
generation of messages to the console during system initialization. 
MSGLVL=0 allows only critical I/O errors or interactive messages to 
appear. MSGLVL=1 allows all messages to be printed. The default is 
MSGLVL=1. 

TSBLK: Applicable only to the CICS/DOS systems, this operand specifies 
I the maximum block size (as a decimal value) for records on the auxiliary 
' temporary storage data set. The default is TSBLK=3625. 

ICV: Specifies the system partition/region exit time interval in 
milliseconds. The default is ICV=1000. For further information 
concerning exit time interval, see the section "System Administration". 

ICVS: Specifies the system stall time interval in milliseconds as a 
decimal value. The default is ICVS=20000. For further information 
concerning stall time interval, see the section "System Administration". 
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ICVR: Specifies the runaway task time interval in milliseconds as a 
decimal value. The default is ICVR=5000. If ICVR=0000, runaway task 
control is suspended for the duration of the current execution of CICS, 
For further information concerning runaway task time, see the section 
"System Administration". 



CDL: Applicable only to the CICS/DOS-ENTRY system, this operand 
specifies the consecutive dispatch limit as a decimal value. The 
default is CDL=5. 

MXT: This operand is used to specify the maximum number of tasks (both 
synchronous and asynchronous tasks in the case of the CICS/DOS-STANDARD 
and CICS/OS-STANDARD systems) that can be initiated concurrently within 
CICS. When the number of active tasks reaches this level, no new tasks 
are initiated by the Terminal Control program. The default is MXT=5. 

TCT...TSP: Each of the operands contained in Figure 1 allows the user 
to specify a two-character suffix which is appended to the standard 
name before loading the CICS nucleus. For example, KCP=B1 causes the 
DFHKCPB1 Task Control module to be included in the CICS nucleus. In . 
each case, the default suffix is blank. 



OPERAND 



STANDARD NAME 



PROGRAM 



TCT=xx 

PPT=XX 

PCT=XX 

FCT=XX,NO 

DCT=XX,NO 

CSA=XX 

KCP=XX 

SCP=XX 

PCP=xx 

DCP=xx,NO 

ICP=xx,NO 

TCP=XX 

FCP=xx 

TDP=xx 

TRP=XX 

PIP=XX,NO 

TSP=xx,NO 



DFHTCT 
DFHPPT 
DFHPCT 
DFHFCT 
DFHDCT 
DFHCSA 
DFHKCP 
DFHSCP 
■DFHP.CP 
DFHDCP 
DFHICP 
DFHTCP 
DFHFCP 
DFHTDP 
DFHTRP 
DFHPIP 
DFHTSP 



Terminal Control Table 
Processing Program Table 
Program Control Table 
File Control Table 
Destination Control Table 
Common System Area 
Task Control Program 
Storage Control Program 
Program Control Program 
Dump Control Program 
Interval Control Program 
Terminal Control Program 
File Control Program 
Transient Data Program 
Trace Control Program 
Program Interrupt Program 
Temporary Storage Program 



No te: If NO is coded, a dummy module is loaded (except in the case 
of PIP where the program interrupt facility is not provided 
if NO is coded) . FCT=NO and DCT=NO cause a dummy FCP and 
a dummy TDP to be loaded, respectively. For CICS/OS, PIP 
must be included in the CICS nucleus if the runaway task 
control feature is to be supported. 

Since CICS does not provide generatable options for DFHPIP 
and DFHTRP, PIP=xx and TRP=xx are used, respectively, only 
if the user wishes to provide his own version of these 
programs, or if the user specified a suffix when generating 
PIP, then that suffix should be used in the SIT. 



Figure 1. Resident program suffixes 



OSCOR: Applicable only to the CICS/OS-STANDARD system, this operand 
specifies a one- to six-digit decimal value indicating the amount of 
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main storage to be provided from the CICS partition/region for the use 
of the operating system during CICS execution. The default is OSCOR=0; 
however, the minimum amount of main storage available to the operating 
system is equal to the size of the System Initialization program 
(DFHSIP) . 

If the value specified is greater than the size of DFHSIP, the amount 
of main storage provided for the use of the operating system is equal 
to the size of DFHSIP plus the amount specified in excess of the size 
of DFHSIP. Note that this main storage is not available to the 
operating system until DFHSIP transfers control to the Dummy CSA program 
(DFHDCSA) . 

The user should be aware that an incorrect OSCOR specification could 
adversely affect system performance. The value specified should 
accurately reflect the amount of main storage required by the operating 
system, depending upon the CICS configuration. 

PL1: The PL1=YES operand indicates that programs coded in PL/I are to 
be processed. The default is PL1=N0. 

DL1: Applicable only to the CICS/OS-STANDARD system, this operand is 
used to indicate whether or not Data Language/I (DL/I) data bases are 
to be accessed during execution of CICS. The default is DL1=N0. 

PSB: Applicable only to the CICS/OS-STANDARD system and only if the 
CICS-DL/I Interface is being generated, this operand is used to specify 
the one- to eight-character name of the Program Specification Block 
(PSB) used during IMS initialization. This PSB contains a Program 
Communication Block (PCB) for each DL/I access method to be used (two 
PCB's in the case of HISAM) , and is used to load all required DL/I 
modules during initialization. The default is PSB=CICSPSB. 

PSBPL: Applicable only to the CICS/OS-STANDARD system and only if the 
CICS-DL/I Interface is being generated, this operand is used to specify 
the Program Specification Block (PSB) pool size in 1024-byte blocks 
for CICS-DL/I Interface support. The number of 1024-byte blocks 
specified must be in the range 0-999. This operand corresponds to the 
PSB operand of the IMS/360 BUFPOOLS system generation macro instruction 
and to the III parameter of the IMS/360 CTL or CTX parameter list for 
online execution. The default is PSBPL=4. 

DMBPL: Applicable only to the CICS/OS-STANDARD system and only if the 
CICS-DL/I Interface is being generated, this operand is used to specify 
the Data Management Block (DMB) pool size in 1024-byte blocks for 
CICS-DL/I Interface support. The number of 1024-byte blocks specified 
must be in the range 0-999. This operand corresponds to the DMB operand 
of the IMS/360 BUFPOOLS system generation macro instruction and to the 
JJJ parameter of the IMS/360 CTL or CTX parameter list for online 
execution. The default is DMBPL=4. 

BUFPL: Applicable only to the CICS/OS-STANDARD~system and only if the 
CICS-DL/I Interface is being generated, this operand is used to specify 
the DL/I data base buffer pool size in 1024-byte blocks. The number 
of 1024-byte blocks specified must be in the range 0-999. This operand 
corresponds to the DBASE operand of the IMS/360 BUFPOOLS system 
generation macro instruction and to the HHH parameter of the IMS/360 
CTL or CTX parameter list for online execution. The default is BUFPL=8. 
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ATP: Applicable only to the CICS/DOS-STANDARD and CICS/OS-STANDARD 

systems, this operand is used to indicate whether or not the 

Asynchronous Transaction Processing facility (ATP) is to be generated. 
The default is ATP=NO. 

ATPMT: Applicable only to the CICS/DOS-STANDARD and CICS/OS-STANDARD 
systems, this operand is used to specify, as a decimal value, the 
maximum number of asynchronous tasks that can be initiated concurrently 
within CICS by the Asynchronous Transaction Processing Control program 
(DFHATP) . When the number of active asynchronous tasks reaches this 
level, no new asynchronous tasks are initiated by DFHATP. The default 
is ATPMT=1. 

ATPMB: Applicable only to the CICS/DOS-STANDARD and CICS/OS-STANDARD 
systems, this operand is used to specify, as a decimal value, the 
asynchronous task inhibitor value. When the number of active tasks 
(both synchronous and asynchronous) reaches this level, the Asynchronous 
Transaction Processing Control program (DFHATP) does not initiate any 
new asynchronous tasks, even though the number of asynchronous tasks 
currently active is less than the value specified in the ATPMT operand. 
Thus, even though no asynchronous tasks are active, none are initiated 
if the total of all other active tasks has reached the level specified 
in this operand. If this operand is omitted, the default value is 
equal to one less than the value specified in the MXT operand. 

SIMODS: Applicable only to the CICS/DOS systems, this operand is used 
to change the last two characters of the phase names of the System 
Initialization overlays and/or allow the addition of one user-written 
overlay. The phase names of the System Initialization overlays are 
located in the DOS Core Image Library and must be seven characters in 
length; the first five characters are DFHSI and the last two characters 
are specified through use of this operand. The default is 
SIMODS= (A2,B1,C1,C2,C3,D1,E1) for the CICS/DOS-ENTRY system and 
SIM0DS=(A2,B1,C1,D1,E1) for the CICS/DOS-STANDARD system. 

The order in which the overlays are executed is determined by the 
sequence of the parameters of the SIMODS specification. For example, 
in response to the SIMODS= (AS, BS,CS,DS,ES) specification, the overlays 
are loaded in the order DFHSIAS, DFHSIBS, DFHSICS, DFHSIDS, DFHSIES. 
In response to the SIMODS= (AS,BS ,CS, DS,US,ES) specification, the 
overlays are loaded in the order DFHSIAS, DFHSIBS, DFHSICS, DFHSIDS, 
DFHSIUS, DFHSIES. 

If an additional user-written overlay is to be provided, the SIMODS 
specification for the CICS/DOS-ENTRY and CICS/DOS-STANDARD systems 
would contain eight parameters and six parameters, respectively. 

TERMINAL CONTROL TABLE (TCT) 

The Terminal Control Table provides a means whereby the user of CICS 
can specify the terminal environment in which the system will operate. 
The Terminal Control Table contains the data needed by the control 
system to perform its terminal management functions. The user can 
create more than one Terminal Control Table to describe both his 
operational and his terminal testing environment. 

The Terminal Control Table macro instruction (DFHTCT) is used to 
specify the user's terminal environment which can include 
telecommunication devices, sequential processing devices, and graphic 
devices. The following operands can be included in the DFHTCT macro 
instruction: 
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DFHTCT TYPE=INITIAL, * 
SOFFIX=XX 

DFHTCT TYPE=SDSCI, * 

DEVADDR=SYSnnn, * 

DEVICE=1 030, 1 050, 1130,1 403 ,1404, 1442, 1443,1445, * 

2020, 2260, L2260, 2265, 231 1,2314, 250 1,2520, * 

2540, 2740, 2740/2760, 274 1C,2741E, 2770, 2780, * 

2980, 3275, 3277, L3277, 3284, 13284,328 6, L3286, * 

3330, 3735, 7770, BSCMDMPT,BSCMDPPT,BSCMDSW,DASD, * 

DISK, SYS/3, SYS/7, S360, TAPE, TW33,TW35,TCAM, * 

DSCNAME=name, * 

ERROPT=E,R,»,C,N,RW,T, * 

FEATURE=(STC,CHK,BSC,KBL,OIU,SIX,SXW,SIW,RIX, * 

RXW,BIW,MAS,SLV,APL) , * 

LINELST= (nnnl,.. . ,nnn31) , * 

SWITCH>YES,NO, * 

CU=2701, 2702, 2703, 2848, 3272, 7770, * 

CONFIG=PPT,MPT, * 

BSCODE=EBCDIC, ASCII, TRANSCODE, * 

MODELST=(n1,...,n31) , * 

RETRY=number, * 

TERMTST=YES,NO, * 

LERBADR=symbolic address, * 

DDNAME=name, * 

MACRF=(R,W), * 

FLNNAHE=name, * 

NCP=number, * 

MODE=(,CNTRL,A or B,A or B) , * 

BLKSIZE=length, * 

RECFM=F,V,U, * 

SYNAD=symbolic name, * 

OPTCD=H,WU,WC,WUC, * 
APPENDG=appendage suffix 

symbol DFHTCT TYPE=LINE, * 

ACCMETH=SAM,BS AM, BTAM,BG AM, TCAM, SEQUENTIAL, GRAPHIC, * 

TELECOMMUNICATION, * 

TRMTYPE=1030,1050, 1053,1 130, 2020, 2260, L2260, 2265, * 

2740, 2740/2760, 274 1C, 2741 E, 2770, 2780, 2980, * 
3275, 3277, L3277, 3284, L3284, 3286, L3286, 3735, 7770, * 

SYS/3, SYS/7, S360,CRLP,DASD, TAPE, TWX,U/R, * 

CLASS=(CONV, BATCH, VIDEO, HARDCOPY, BISYNC, AUDIO) , * 

DSCNAME=name, * 

ISADSCN=name, * 

OSADSCN=name, * 

INAREAL=length, * 

TRMMODL=number or character, * 

BTAMRLN=number, * 

LISTADR= (name, WRAP) , * 

FEATURE=(AUTOANSR, AUTOCALL, AUTOPOLL, CHECKING, * 

SCONTROL,BUFFRECV,KBRDLOCK) , * 

NPDELAY=number, * 

PO0LADR=symbolic address, * 

ANSWRBK=AUTOMATIC, TERMINAL, NULL,EXIDVER, * 

LINSTAT=«OUT OF SERVICE*, * 

BSCODE=EBCDIC, ASCII, TRANSCODE, * 

CONVTAB=EBCDIC,ASCII,TRANSCODE,TEXTMODE,ABB,ABC, * 

RDYMSG=symbolic address, * 

ERRMSG=symbolic address, * 

GENPOLL=YES, * 

POOLCNT=number, * 

TCTUAL=number, * 

OUTQ=symbolic name, * 

PO0L=YES, * 
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QUEUEID=hexadecimal number * 

symbol DFHTCT TYPE=TERMINAL, * 

TRMIDNT=name, * 

TRMPRTY=number, * 

TRMMODL=number, character, * 

TRMTYPE=1 030,1 050 , 1053, 1130, 2020, 2260,12260,2265, * 

2740, 2740/2760, 2741C,2741E, 2770, 2780, 2980, * 

3275, 3277,L3277, 3284, 1,3284,3286, L3286, 3735, 7770, * 

SYS/3, SYS/7,S360,CRLP,DASD, TAPE, TWX,U/R, * 

CLASS= (CONV, BATCH, VIDEO, HARDCOPY,BISYNC, AUDIO) , * 

LVONIT=number, * 

LASTTRM=LINE,GACB,POOL, * 

TRMADDR=address,name, * 

TRMSTAT= (TRANSACTION, TRANSCEIVE,RECEIVE, f OUT OF SERVICE 1 ,* 

INPUT) , * 

COMPAT=NO, (number of characters, number of lines, * 

device type, model number), * 

FEATURE=(PTRADAPT,SELECTPEN,AUDALARM,COPY,BUFEXP, * 

DCKYBD,UCTRAN) , * 

POLLPOS=number, * 

TRANSID=name, * 

STN2980=number, * 

TAB2980=number, * 

TIOAL=number, * 

TCTUAL=number 

symbol DFHTCT TYPE=7770MSG, * 

MESSAGE= I message 1 

DFHTCT TYPE=FINAL 

ESTABLISH CONTROL SECTION FOR TERMINAL CONTROL TABLE 

The area of main storage into which the Terminal Control Table is 
assembled is established in response to the 

DFHTCT TYPE=INITIAL, * 

SUFFIX=XX 

macro instruction, which must precede all other DFHTCT macro 
instructions in a Terminal Control Table assembly. 

SUFFIX: This operand specifies a two-character alphameric suffix for 
the Terminal Control Table being assembled. This suffix, if specified, 
is appended to the standard module name (DFHTCT) and is used to name 
the module on the linkage editor output library. If this operand is 
omitted, a suffix is not provided. 
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SPECIFY DATA SET CONTROL INFORMATION 

The user must specify data set control information through use of 
the 

DFHTCT TYPE=SDSCI 

macro instruction, which causes the control system to generate the 
appropriate data set control information. DTF information is generated 
in the CICS/DOS systems; DCB information is generated in the CICS/OS 
system. This macro instruction can include the following operands: 

DFHTCT TYPE=SDSCI, * 

DEVADDR=SYSnnn, .* 

DEVICE=1 030 ,10 50, 1130, 1403 ,1404,1442,1443,1445, * 

2020, 2260, L2260, 2265,2311, 2314,2501, 2520, * 

2540, 2740, 2740/2760, 2741C,2741E, 2770,2780, * 

2980, 3275, 3277, L3277, 3284, L3284, 3286,13286, * 

3330,37 35,7770,BSCMDMPT,BSCMDPPT,BSCMDSW,DASD, * 

DISK, SYS/3, SYS/7, S360,TAPE,TW33,TW35,TCAM, * 

DSCNAME=name, * 

ERROPT=E,R,W,C,N,RW,T, * 

FEATURE=(STC,CHK,TRC,BSC,KBL,OI0,SIX,SXW,SIW,RIX, * 

RXW,RIW,MAS,SLV,APL) , * 

LINELST= (nnnl,.. . ,nnn31) , * 

SWITCH=YES,NO, * 

"-^1^270 1,2702, 270 3, 2848, 3272 ,7770, * 

CONFIG=PPT,MPT, * 

BSCODE=EBCDIC, ASCII, TRANSCODE, * 

MODELST=(n1,.. .,n31) , * 

RETRY=number, * 

TERMTST=YES,NO, * 

LEEBADR=symbolic address, * 

DDNAME=name, * 

MACRF=(R,W), * 

FLNNAME=name, * 

NCP=number, * 

MODE= (,CNTRL,A or B,A or B) , * 

BLKSIZE=length, * 

RECFM=F,V,U, * 

SYNAD=symbolic name, * 

OPTCD=W,WU,WC,WUC, * 

APPENDG=appendage suffix 

Two DFHTCT TYPE=SDSCI macro instructions must be coded for each 
seguential terminal. One macro instruction is for the seguential input 
data set and the other macro instruction is for the sequential output 
data set. This input/output data set combination simulates the input 
and output functions of a terminal. One DFHTCT TYPE=LINE macro 
instruction must be coded for this I/O combination. 

One DFHTCT TYPE=SDSCI macro instruction must be coded for each BTAM 
line group, where a line group is a group of communication lines that 
meet the following operational requirements: 

1. All lines in the group are attached to the channel through the 
same type of telecommunications control unit; for example, a 
2701. (This is true only for the CICS/DOS systems.) 

2. The line connection between the control unit and the remote 
devices is of the same type; for example, a switched network. 

3. All devices within the line group have the same line features 
and operating characteristics; for example, autopoll. 
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DEVADDE: Applicable only to the CICS/DOS systems, this operand 
specifies the symbolic unit address (sequential device) used for 
sequential terminal data sets. 

DEVICE: Specifies the valid device types for this Terminal Control 
Table. L2260 siqnifies "local video attachment". 2260 and 2265 signify 
"remote video attachment". L3277, L3284, and L3286 signify "local 3270 
attachment". 3275, 3277, 3284, and 3286 signify "remote 3270 
attachment". BSCMDPPT signifies "mixed binary synchronous 
point-to-point devices". BSCMDSW signifies "mixed binary synchronous 
switched devices". BSCMDMPT signifies "mixed binary synchronous 
multipoint devices". For direct access devices, specify either the 
device type or the generic parameter DASD or DISK. 

Support for a 1053 printer is included when 2260, L2260, or 2265 is 
specified. In the CICS/OS-STANDARD system, this operand automatically 
generates the MACRF operand. 

A 2740 Communication Terminal with 2760 Optical Image Unit can be 
specified as either a 2740 or 2740/2760. 

DEVICE=TCAM (applicable only to CICS/OS) causes CICS to generate 
the appropriate data set control information to handle the TCAM input 
or output process queue. 

Note.: In the generation of a TCAM-only system, the following 

operands do not apply to TCP and TCT: ANSWRBK, BTAMDEV, BSCODE, 
CONVTAB, FEATURE, INITRL, LOCKF, UCTRAN=ASCII, WRAPLST, XINPUT, 
XOUTPUT. 

DSCNAME: Specifies the symbolic data set control name associated with 
the data set control information. 

The DSCNAME for the sequential input data set must be the same name 
as that specified in the ISADSCN=name operand of the DFHTCT TYPE=LINE 
macro instruction. The DSCNAME for the sequential output data set must 
be the same name as that specified in the OSADSCN=name operand of the 
DFHTCT TYPE=LINE macro instruction. 

The DSCNAME for BTAM data sets must be the same name as that 
specified in the DSCNAME=name operand of the DFHTCT TYPE=LINE macro 
instruction. 

ERROPT: Specifies the error recovery, error recording, and online test 
options to be provided for the line group. The applicable keyword 
parameters are: 

1. E, specifies that the basic error recovery procedures are to be 
provided for the line group. If ERROPT is omitted, ERROPT=E is 
assumed. 

2. R, specifies that text-read errors are to be retried in addition 
to the basic error recovery procedures. This option is valid 
only for the following terminals: 10 50 terminals (valid for 

the card reader and paper tape reader only if the line correction 
feature is installed) , 2740 terminals with the checking feature, 
and 2260 terminals. 

3. W, specifies that text-write errors are to be retried in addition 
to the basic error recovery procedures. This option is valid 
for all start-stop terminals. It is invalid for binary 
synchronous terminals. It results in an additional copy of the 
message for each retry (except for the 2260 with the line address 
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feature, and the 1050 card punch and paper tape punch with the 
line correction feature) . This parameter is ignored for binary 
synchronous terminals. 

4. C, specifies that threshold error counts and cumulative error 
counts are to be maintained in the line error recording block 
(LERB) for the line for data check, intervention required, and 
nontext timeout errors. This parameter is applicable only to 
the CICS/OS-STANDARD system. 

5. N, specifies that no error recovery procedures are to be provided 
for the line group. This parameter and E,R,W, and C are mutually 
exclusive. This parameter is invalid for binary synchronous 
stations; if coded, it is ignored. 

6. RW, specifies that error recovery is to be performed with "read 
text retry" and "write text retry". 

7. T, specifies that the online test facility is to be used for 
the line group. Applicable only to the CICS/OS-STANDARD system, 
this parameter is valid for all IBM terminals with or without 
error recovery capability. 

Note: For CICS/OS, EROPT is also a valid spelling of this operand. 
Commas must not be coded in this parameter. For example, 
ERROPT=RECWT. 

FEATURE: Applicable only to the CICS/DOS systems, this operand 
specifies device-dependent machine special features and programming 
special features. The applicable keyword parameters are: 

l 1. STC, specifies that the 2740 or System/7 is equipped with the 
' station control feature. 

2. CHK, specifies that the 2740 is equipped with checking feature, 

(CHK must always be specified for the System/7.) 

3. BSC, must be coded when the DEVICE operand specifies a binary 
synchronous device. 

4. KBL, specifies that the 2848 control unit is equipped with the 
data entry feature. The Lock optypes are rejected as undefined 
if this parameter is not used. 

5. OIU, specifies that a 2760 Optical Image Unit is attached to a 
2740 with the checking feature and, optionally, the dial feature. 

6. SIX, SXW, or SIW, used if ID verification for a calling operation 
is to occur in a binary synchronous point-to-point dial system. 

A more detailed explanation of these codes is given in the 
publication, DOS Basi c Telecommunications Acc ess Method 
(GC30-5001). (See Note) 

7. RIX, RXW, or RIW, used if ID verification for an answering 
operation is to occur in a binary synchronous point-to-point 
dial system. A more detailed explanation of these codes is 
given in the publication, D OS Basic Telecommun ication s Access 
Method (GC30-5001). (See Note)" 

8. MAS or SLV, used to specify whether the CPU is to be Master 
(MAS) or Slave (SLV) when contention occurs in a binary 
synchronous CPU-to-CPU contention system (private line) . If 
this operand is not used, FEATURE=MAS is assumed for this system. 
If FEATURE=MAS is specified, the remote device is to be the 
slave when contention occurs. If FEATURE=SLV is specified, the 
remote device is the master. When the remote device is the 
2780, FEATURE=SLV must always be coded. The CPU must always be 
the slave when contention occurs between the CPU and the remote 
2780. 

9. APL, specifies that the autopoll feature is to be employed for 
the start-stop devices. If FEATURE=APL is omitted, the generated 
channel programs for these devices will perform the standard 
programmed polling. A more detailed explanation of this code 

is given in the publication, DOS Basic Tel eco mmunications Access 
Method (GC30-5001) . 
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Note:. These parameters should not be used with "Extended ID 

Verification", i.e., they should not be coded if ANSWRBK=EXIDVER 
is coded for TYPE=LINE. 

LINELST: Applicable only to the CICS/DOS systems, this operand 
specifies the correspondence between symbolic unit (SYSnnn) and relative 
line number. The user codes one three-digit number (nnn of SYSnnn) 
for each line in the line group. The order in which the three-digit 
numbers are coded determines which symbolic units are associated with 
the individual lines in the line group. As many as 31 three-digit 
numbers from 000-244 may be coded in this operand. 

For local 2260's and local 3270*3, each number entry represents a 
physical device; all local devices attached to the same control unit 
must be specified in the same LINELST operand. 

SWITCH: Applicable only to the CICS/DOS systems, this operand specifies 
the type of line connection between the system and the remote device. 
SWITCH=YES indicates that the line connection is through a switched 
network. SWITCH=N0 indicates that the line connection is dedicated. 
The default is SWITCH=NO. 

CU: Applicable only to the CICS/DOS systems, this operand defines the 
control unit attached to the channel (such as a 2701, 2702, 2703, 2848, 
3272 or 7770) . This operand is reguired for all non-seguential devices. 
If using the System/360 Model 25 with the Integrated Communications 
Attachment, CU=2703 must be specified; for System/370 with Integrated 
Communications Attachment, CU=2701 must be specified. 

CONFIG,: Applicable only to the CICS/DOS systems, this operand specifies 
the type of binary synchronous line configuration. CONFIG=PPT indicates 
that the data link between the CPU and the remote binary synchronous 
device is point-to-point. CONFIG=MPT indicates that the data link 
between the CPU and the remote binary synchronous devices is a 
multi-point link. The default is CONFIG=PPT. 

BSCODE: Specifies the type of binary synchronous transmission code. 
BSCODE=EBCDIC indicates transmission in Extended Binary Coded Decimal 
Interchange Code. BSCODE=ASCII indicates transmission in American 
Standard Code for Information Interchange. BSCODE=TRANSCODE indicates 
transmission in six-bit TRANSCODE. The default is BSCODE=EBCDIC. 

MODELST: Applicable only to the CICS/DOS systems, this operand is used 
to specify a code (0,1,2,3) for each line in a binary synchronous line 
group to be used by BTAM at OPEN time. If this operand is omitted, 
code is assumed for each line in the line group. A more detailed 
explanation of this operand is given in the publication DOS Basic 
Telecommunications A cces s Method (GC30-5001) . CICS does not support 
the use of codes 4, 5, 6, and 7. If converting from CICS/DOS to 
CICS/OS, this operand must be recoded as MODE. 

RETRY: Specifies the number of retries (0-15) by BTAM for recoverable 
errors that occur on I/O operations for binary synchronous 
communication. If this operand is omitted, RETRY=7 is assumed. 

TERMTST: Applicable only to the CICS/DOS systems, this operand 
specifies whether or not the online terminal test facility is to be 
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used. The default is TEEMTST=NO. A more detailed explanation of this 
operand is given in the publication, DOS Basic Telecommunicatlong Ac ces s 
Method (GC30-5001) . For CICS/OS r the online terminal test facility is 
specified through the ERROPT operand. 

LERBADR: Specifies the label of the BTAM line error recording block 
(LERB) in which the user has specified his LERB parameters. For 
CICS/OS, this operand is valid only if ERROPT=C is also specified. For 
CICS/OS, LERB is also a valid spelling of this operand. 

DDNAME: Applicable only to the CICS/OS-STANDARD system, this operand 
is used to supply the name of the data definition (DD) statement 
associated with a particular data set (line group) . If converting from 
CICS/DOS to CICS/OS and this operand is omitted, the DSCNAME becomes 
the DDNAME. 

MACRF: Applicable only to the CICS/OS-STANDARD system, MACRF=(R,W) 
indicates that access to the BTAM line group or to sequential devices 
is to be gained via either READ or WRITE macro instructions, or both. 
The default for BTAM line groups is MACRF=(R,W); the OPEN option for 
BTAM line groups defaults to input. 

For sequential devices (other than card reader and line printer) , 
MACRF=R or MACRF=W must be specified. The default is MACRF=R for a 
card reader and MACRF=W for a line printer. 

FLNNAME: Applicable only to the CICS/OS-STANDARD system, this operand 
is used to supply the name of the first communication line entry that 
is defined by the DFHTCT TYPE=LINE macro instruction for local 2260* s. 

NCP: Applicable only to the CICS/OS-STANDARD system, this operand is 
used to indicate the number of channel programs that are to be specified 
when using the Graphics Access Method. The default is NCP=1. 

MODE: Applicable only to the CICS/OS-STANDARD system, this operand 
specifies the mode of communication for a binary synchronous line group. 
A more detailed explanation of this operand is given in the publication, 
OS Basi c Telecommunica tio ns Access Method (GC30-2004) . Note that since 
CICS does not support the IBC parameter described in GC30-2004, a comma 
must be substituted in place of the IBC parameter. 

BLKSIZE: This operand is used for sequential data sets and 7770 Model 
3*s to specifiy th maximum length (in bytes) of a block. For 7770 
Model 3»s this value should be the same as that specified for INAREAL 
in the line entries that reference the DSCNAME of this DFHTCT TYPE=SDSCI 
macro instruction. 

For the CICS/OS-STANDARD system, the default is BLKSIZE=0. If this 
operand is omitted, the block size can be specified in the data 
definition (DD) statement associated with the data set. A more detailed 
explanation of this operand is given in the publication OS Su per visor 
and Data Management Mac ro Inst ructi ons, GC28-6647. 

For the CICS/DOS systems, the default is BLKSIZE=80. A more detailed 
explanation of this operand is given in the publication DOS Supe rvisor 
and 1^0 Macr os, GC2U-5037. 
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RECFM: Applicable only to the CICS/OS-STANDARD system, this operand 
is used for sequential data sets to specify the record fromat for the 
DCB. Applicable keyword parameters are F (fixed-length records), V 
(variable-length records) , and U (undefined records) . The default is 
RECFM=U. If this operand is omitted, the record format can be specified 
in the data definition (DD) statement associated with the sequential 
data set. 

SYNAD: Applicable only to CICS/OS with TCAM, this symbolic name 
specifies the address of a subroutine to be given control if message 
processing is used; the work unit is larger than the work area, and 
OPTCD=C is not specified. 

For input queues, the user has the option of specifying his own 
SYNAD routine for which an EXTRN is generated. If SYNAD is not 
specified, a CICS generated SYNAD routine is provided. If CICS SYNAD 
is used and the exit occurs: 

1. Message DFH4000 is issued. 

2. The DCB is closed. 

3. The DCB is reopened. 

4. Data is truncated to the specified blocksize and is passed to 
the CICS application program. 

OPTCD: Applicable only to CICS/OS, this operand specifies the optional 
fields for the TCAM work unit. The W specifies that for input, the 
name of the source of each message is to be placed in an eight-byte 
origin field in the work area. For output, it specifies that TCAM 
expects the name of the destination of the message to be placed in an 
eight-byte destination field in the work area before a TCAM WRITE macro 
instruction is executed. OPTCD=W must be specified for both the input 
and output macro instruction. 

U specifies that the work unit to be handled is either a message or 
a message segment that is not a record. If is omitted, the work unit 
is assumed to be a record. 

C specifies that a one-byte field in the work area, called the 
position field, indicates whether the work unit being handled is the 
first, an intermediate, or the last segment of the message, and, on 
input, whether a record delimiter has been detected in the data. 

For further information concerning the OPTCD operand, see the OS/MFT 
and OS/MVT TCAM Programmer's Guide (GC30-2024) . 

APPENDG: Applicable only to the CICS/OS-STANDARD system when 
DEVICE=7770 is specified, this operand is used to specify a 
two-character alphameric suffix for the 7770 Channel End/Abnormal End 
Appendage routine. The suffix specified must be in the range WA-Z9 
and must be the same suffix as was specified in the CAA operand of the 
DFHSG PR0GRAM=CS0 macro instruction. 

DESCRIBE COMMUNICATION LINES 

Communication paths to the terminals on the system are described by 
the DFHTCT TYPE=LINE macro instruction. The expansion of this macro 
instruction is the Terminal Control Table line entry (TCTLE) and 
contains the Data Event Control Block (DECB) that is used to communicate 
with the appropriate access method. The terminals related to this line 
must be described immediately following this macro instruction through 
use of the DFHTCT TYPE=TERMINAL macro instruction. However, when 
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describing a switched-line network, all the lines for a given pool 
should be described before describing the terminals for that line pool. 

If TCAM is used, the TCTTE»s that follow a TCAM TCTLE represent: 

1. Physical terminals, if POOL=YES is not coded. 

2. The maximum number of tasks (transactions) that can be 
initiated for this TCTLE, if POOL=YES is coded. 

The following operands can be included in the DFHTCT 
TYPE=LINE macro instruction: 

symbol DFHTCT TYPE=LINE, * 

ACCMETH=S AM, BS AM, BTAM,BGAM, TCAM, SEQUENTIAL, GRAPHIC * 

TELECOMMUNICATION, * 

TRMTYPE=1030, 1050, 1053, 113 0,2020, 2260 f L2260, 2265, * 

2740, 2740/2760, 274 1C, 2741 E, 2770, 2780, 2980, * 
3275, 3277, L3277, 32 84, L3284, 3286, L3 286, 3735, 7770, * 

SYS/3, SYS/7, S360,CRLP,DASD, TAPE, TWX,U/R, * 

CLASS=(CONV, BATCH, VIDEO, HARDCOPY, BISYNC, AUDIO) , * 

DSCNAME=name, * 

ISADSCN=name, * 

OSADSCN=name, * 

INAREAL=length, * 

TRMMODL=number, character, * 

BTAMRLN=number, * 

LISTADR= (name, WRAP) , * 

FEATURE=(AUTOANSR, AUTOCALL, AUTOPOLL, CHECKING, * 

SCONTROL,BUFFRECV,KBRDLOCK) , * 

NPDELAY=number, * 

POOLADR=symbolic address, * 

ANSWRBK=AUTOMATIC, TERMINAL, NULL, EXIDVER, * 

LINSTAT=*OUT OF SERVICE 1 , * 

BSCODE=EBCDIC, ASCII, TRANSCODE, * 

CONVTAB=EBCDIC, ASCII, TRANSCODE, TEXTMODE, ABB, ABC, * 

RDYMSG=symbolic address, * 

ERRMSG=symbolic address, * 

GENPOLL=YES, * 

POOLCNT=number , * 

TCTUAL=number, * 

OUTQ=symbolic name, * 

POOL=YES, * 
QUEUEID=hexadecimal number 

One or more DFHTCT TYPE=LINE macro instructions must be coded for 
each line group. The DSCNAME=name operand of each of the DFHTCT 
TYPE=LINE macro instructions must contain the same name as was specified 
in the DSCNAME=name operand of the related DFHTCT TYPE=SDSCI macro 
instruction. 

A DFHTCT TYPE=LINE macro instruction must be coded for each logical 
pair of sequential SDSCI macro instructions. 

A DFHTCT TYPE=LINE macro instruction must be coded for each symbolic 
unit (relative line) coded in the LINELST=parameter operand of the BTAM 
SDSCI macro instruction. The DFHTCT TYPE=LINE macro instruction entries 
must be contiguous on switched-line pools. For the local 2260 Display 
Station under CICS/DOS and the local 3270 Information Display System 
under CICS/DOS or CICS/OS, only one DFHTCT TYPE=LINE macro instruction 
is coded for each line group. 

Note : For sequential devices, the last entry in the input stream must 
be »CSSF GOODNIGHT* to provide a logical close. If all input 
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is sequential, ' CSMT SHUTDOWN' must be entered at one of the 
terminals to terminate CICS. 

ACCMETH: This operand is used to specify the access method to be used. 
Grouped according to synonymity of function, the applicable keyword 
parameters are: 

1. SAM, BSAM, SEQUENTIAL 

2. BGAM, GRAPHICS (CICS/OS only) 

3. BTAM, TELECOMMUNICATION 

U. TCAM, TELECOMMUNICATION (CICS/OS only) 

TRMTYPE: This operand is used to specify the terminal type associated 
with this communication line. Only one TRMTYPE operand can be included 
in each DFHTCT TYPE=LINE macro instruction. This operand, when 
specified, establishes the default specification that will be used when 
the TRMTYPE operand is not specified in a DFHTCT TYPE=TERMINAL macro 
instruction associated with this line. If no TRMTYPE operand is 
specified in the DFHTCT TYPE=LINE macro instruction, a TRMTYPE operand 
must be supplied in each DFHTCT TYPE=TERMINAL macro instruction for 
that line. 

The use of the TRMTYPE operand in the DFHTCT TYPE=LINE macro 
instruction is optional unless one of the following conditions exists: 

1. A 7770 is associated with the line, 

2. A local 3270 is associated with the line. 

3. One or more remote 3270*s are associated with the line. 

In each of these cases an appropriate device-type parameter must be 
specified in the TRMTYPE operand; for example: 

1. TRMTYPE=7770 for the 7770. 

2. TRMTYPE=L3277, TRMTYPE=L328U, or TRMTYPE=L3286 for a local 3270. 

3. TRMTYPE=3275, TRMTYPE=3277, TRMTYPE=3284 , or TRMTYPE=3286 for 
a remote 3270. 

TWX is the Common Carrier Teletypewriter Exchange Terminal Station 
(Model 33/35) , DASD is the direct access storage device, CRLP is the 
card reader and line printer (a pair of sequential devices simulating 
a terminal) , TAPE is the magnetic tape device, and U/R is a general 
term that refers to any reader, printer, or punch. 1053 indicates a 
1053 Printer Model 4. 

CLASS: This operand is used to indicate the device classification 
associated with this communication line. The applicable keyword 
parameters are: 

Device with conversational type application 

Data collection type device 

Device with cathode ray tube 

Start/stop hard-copy device 

Binary synchronous device 

Audio response device 

Multiple parameters may be specified, except that parameters within 
the following groups are mutually exclusive: CONV and BATCH; VIDEO, 
HARDCOPY, and AUDIO. 

DSCNAME: Specifies the data set control information for this 
communication line. It is not applicable for BSAM. The DSCNAME for 

63 



1. 


CONV 


2. 


BATCH 


3. 


VIDEO 


4. 


HARDCOPY 


5. 


BISYNC 


6. 


AUDIO 



BTAM data sets must be the same name as that specified in the 
DSCNAME=name operand of the related DFHTCT TYPE=SDSCI macro instruction. 
In case of TCAM, this operand specifies the data set control name for 
an input TPROCESS queue; the OUTQ operand is also required. 

ISADSCN: Specifies the input BSAM data set control name for a 
particular communication line. This data set control name must be the 
same name as that specified in the DSCNAME=name operand of the related 
DFHTCT TYPE=SDSCI macro instruction. This operand is not applicable 
to BTAM r GAM, or TCAM. 

OSADSCN: Specifies the output BSAM data set control name for a 
particular communication line. This data set control name must be the 
same name as that specified in the DSCNAME=name operand of the related 
DFHTCT TYPE=SDSCI macro instruction. This operand is not applicable 
to BTAM or GAM. In the case of TCAM, this operand specifies the data 
set control name for an output TPROCESS queue; the OOTQ operand may 
not be used. 

INAREAL: Specifies the message input area length. This value, as a 
minimum, must be specified as follows: 

1. For start/stop devices, the length should be equal to the length 
of the longest initial sentence of a transaction. 

2. For start/stop devices with the buffer receive feature (for 
example, the 2740 Communication Terminal Model 2) , the length 
should be equal to the length of the buffer less two bytes. 

3. For binary synchronous devices, the length may be calculated as 
(a+1) (b+2) + 1, where "a" is the number of blocks sent by a 
device in response to an RVI (reverse interrupt) from CICS, and 
"b" is the size, in bytes, of each block. 

4. For the local 2260 Display Station under CICS/DOS, the length 
of the input message can at no time be greater than the length 
specified through this operand. 

5. For the remote 3270 Information Display System, the length 
specified should not be less than 254. 

6. For the local 3270 Information Display System, the value 
specified may be any number greater than zero. This value 
indicates the minumum size of the Terminal Input/Output Area 
(TIOA) that will be passed to the transaction by the Terminal 
Control program. However, for performance considerations, the 
value specified should be equal to or greater than the length 
of the expected input message; at no time can a message be read 
whose length exceeds the INAREAL value by more than 2000 bytes 

(unless the transaction provides a TIOA for the read large enough 
to contain the message). 

7. For sequential devices, the length should be equal to the 
blocksize (and record length) of the data set. 

TRMMODL: This operand specifies the model number of the terminal 
associated with this communication line. This operand must be used if 
the device is one of the following: 

1. Component of the 1050 Data Communication System 

2. 2740 Communication Terminal Model 2 

3. Component of the 2980 General Banking Terminal System 

4. Component of the 3270 Information Display System 

5. 2740 Communication Terminal with 2760 Optical Image Unit 

6. 2260 Display Station 

7. 2265 Display Station 
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The TRMMODL parameter sets the default value that will be taken, 
when it is not specified in the DFHTCT TYPE=TERMINAL macro instruction 
associated with that line. If models vary on a line, the macro 
instruction can have a TRMMODL parameter associated with it, which is 
different from that specified in the DFHTCT TYPE=LINE. This will 
override the DFHTCT TYPE=LINE macro for that DFHTCT TYPE=TERMINAL macro. 

TRMM0DL=1 is used to specify the 2980 Teller Station Model 1, 3275 
Display Station Model 1, 3277 Display Station Model 1, 3284 Printer 
Model 1, or 3286 Printer Model 1. TRMMODL=1 is the default for the 
3270 Information Display System. 

TRMMODL=2 is used to specify the 2740 Communication Terminal Model 
2, 2980 Administrative Station Model 2, 3275 Display Station Model 2, 
3277 Display Station Model 2, 3284 Printer Model 2, or 3286 Printer 
Model 2. 

TRMMODL=4 is used to specify the 2980 Teller Station Model 4. 

TRMMODL=5 is used to specify component polling of the keyboard for 
the 1050 Data Communication System using non-switched communication 
lines. Component selection character 5 (0B) must be coded in the 
polling list (DFTRMLST) . See note. 

TRMMODL=6 is used to specify component polling of reader 1 for the 
1050 Data Communication System using non-switched communication lines. 
Component selection character 6 (0D) must be coded in the polling list 
(DFTRMLST) . See note. 

TRMMODL=7 is used to specify (1) the 2740 Communication Terminal 
with 2760 Optical Image Unit, or (2) component polling of reader 2 for 
the 1050 Data Communication System using non-switched communication 
lines. Component selection character 7 (0E) must be coded in the 
polling list (DFTRMLST) . See note. 

TRMMODL=0 is used to specify an input component for the 1050 Data 
Communication System. Common polling character (15) must be coded 
in the polling list (DFTRMLST) . TRMMODL=0 is the default specification 
for a 1050 Data Communication System. 

The TRMMODL=character operand is used to specify the applicable 
screen format for a 2260/2265 Display Station as follows: 

SPECIFICATION SCREEN FORMAT 

TRMMODL=A 6x40 2260 

TRMMODL=B 12x40 2260 

TRMM0DL=C 12x80 2260 

TRMMODL=D 15x64 2265 

TRMMODL=E 12x80 2265 

For example, TRMMODL=A specifies a 2260 Display Station with a 6x40 
screen format. 

Note: When TRMMODL is specified, the user must also specify the 

component selection character with control unit address via the 
TRMADDR operand of the DFHTCT TYPE=TERMINAL macro instruction. 

BTAMRLN: Specifies the relative line number within a line group. The 
relative line number can be specified in the range 1-31 for CICS/DOS 
and 1-256 for CICS/OS. This operand is not applicable to BSAM, BGAM, 
TCAM, or local 2260»s under DOS. 
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LISTADR: Specifies the label of the BTAM Define Terminal List macro 
statement (DFTRMLST) in which the user has specified his polling list 
for the communication line. (A terminal may not be specified more than 
once in a polling list.) DFTRMLST entries should be coded immediately 
preceding DFHTCT TYPE=LINE entries or immediately following DFHTCT 
TYPE=TERMINAL entries. If a wraplist is specified in the DFTRMLST, 
the WRAP operant! must be included. The default is to an open list. 
LISTADR is not applicable when ACCMETH=BSAM, ACCMETH=GAM, or for some 
devices when ACCMETH=BTAM (for example, dial-up 2741»s). 

For more information, see the publication DOS Basic 
Telecommunications Access Metho d (GC30-5001) or the publication OS 
Basic Telecommunications Acces s Method (GC30-2004) . 

Note: Polling list entries for remote 2260/2265 and remote 3275/3277 
systems must specify a general poll. The use of a general poll 
allows a single entry in the polling list to invite input from 
all devices attached to each remote control unit or display 
station. 

In this form of operation, the polling list should contain only 
one entry for each 2845, 2848, or 3271 Control Unit or for each 
3275 Display Station on the line. For 2260/2265 display systems, 
this form of operation is achieved by coding X'FF' as the second 
byte of each entry in the polling list. For 3270 systems, this 
form of operation is achieved by using a device address code of 
X«7F' (EBCDIC) or X'22* (ASCII) in each polling list entry 
applicable to a 3271 Control Unit or 3275 Display Station. For 
remote 3270* s, see the discussion of GENPOLL in this section 
and the discussion of POLLPOS in the section "Describe Terminal 
Types". 

If ANSWRBK=EXIDVER is specified, the LISTADR operand must specify 
the label of a DFTRMLST macro instruction of the SWLST,AN format. The 
user data portion of the entries in this list must be either of the 
following: 

1. The label of the corresponding DFHTCT TYPE=TERMINAL macro 
instruction for each 3735; or 

2. Hexadecimal zeros for terminals that share the line with the 
3735 but do not transmit unigue ID seguences. 

For a dial-up line containing 3735* s and other bisynchronous devices, 
the answering list must be coded as follows: 

symbol DFTRMLST SWLST, AN, XX, 4 ,yy r zz, * 

(authseguence, 0, userdata) , , , * 

(2D,0,ZERO) 

where: symbol is the user label specified by the LISTADR= operand of 
the DFHTCT TYPE=LINE macro instruction, xx,yy,zz as defined in 
the BTAM manual, (authseguence, 0,userdata) is a sublist in the 
answering list for each 3735 (authseguence is defined in the 
BTAM manual) , must be specified for the control value, userdata 
is the label of the DFHTCT TYPE=TERMINAL entry and (2D, 0, ZERO) 
is a sublist in the answering list for all non-3735 devices on 
the line where 2D is the ID ENQ sequence for non-3735 devices, 
must be specified for the control value, ZERO is the label 
used to represent userdata (the following statement must be 
coded: ZERO EQU 0) . 

FEATURE: This operand is used to indicate that one or more optional 
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features are present on a given terminal. These features can be 
specified in any order using the following keyword parameters: 

1. AUTOANSR, the automatic answering capability for switched lines. 

2. AUTOCALL, the automatic calling capability for switched lines. 

3. AUTOPOLL, the automatic polling capability reguired for 
multi-point binary synchronous communication terminals and 
optional for the 1050 Communication System and 2740 Communication 
Terminal. If AUTOPOLL is specified for the 2740, SCONTROL must 
also be specified. 

4. CHECKING, the VRC/LRC feature on the 2740 Communication Terminal. 

5. SCONTROL, the station control feature on the 2740 Communication 
Terminal and on the System/7. 

6. BUFFRECV, the buffer receive capability for the 2740 
Communication Terminal Model 2. If BUFFRECV is specified, 
SCONTROL must also be specified. 

7. KBRDLOCK, the lock option capability for the 2848 Display Control 
Models 21 and 22. 

For terminals on switched-line networks, FEATURE= AUTOANSR must always 
be specified. 

NPDELAY: Applicable only to start/stop and BISYNCH devices, this 
operand is used to specify the interval of time, in milliseconds, 
between line polls (invitations) when a negative response to a poll is 
detected. This number can be specified in the range to 20000, with 
default values varying by device type. NPDELAY signifies "negative 
poll delay". 

When used with a TCAM line, this operand specifies the time interval 
that is to expire before control is passed to TEP when a CICS task is 
not ready to accept a subseguent record from the input process queues. 
If the CICS task issues a read before the time interval expires, 
processing continues normally and TEP is not notified. This number 
can be specified in the range of to 20,000 milliseconds. The default 
value is 0. 

POOLADR: This operand must be used for switched-line processing and 
for the local 3270 Information Display System. Used for switched-line 
processing, this operand specifies the label assigned to the first 
terminal description (DFHTCT TYPE=TERMINAL) associated with a particular 
pool of communication lines. POOLADR should be coded only for the 
first line in a given line pool; FEATURE=AUTOANSR must also be 
specified. 

Used for the local 3270 Information Display System, this operand 
specifies the label assigned to the first terminal description 
associated with a particular pool of local 3270 •s. FEATURE=AUTOANSR 
need not be specified. 

ANSWRBK: This operand must be coded for switched lines to specify the 
terminal identification to be used. If this operand is used, 
FEATURE=AUTOANSR must also be specified. Only one of the following 
keyword parameters may be specified: 

1. AUTOMATIC, indicates automatic terminal identification. This 
parameter may be coded only for the Common Carrier Teletypewriter 
Exchange Terminal Station (Model 33/35) . 

2. TERMINAL, indicates that the terminal will be identified by the 
operator. This parameter may be coded for the TWX, 1050, 2740, 
2741, and dial-up binary synchronous devices. (After the dial-up 
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connection has been made, the operator must enter the Terminal 
Identification as it appears in the Terminal Control Table.) If 
3735's share the line, specify EXIDVER. 

3. NULL, indicates that the terminal will not be identified by 
either the terminal or operator. This parameter may be coded 
only for the 7770. (After the dial-up connection has been made, 
the Terminal Control program connects this line to the next 
available terminal in the terminal pool.) 

4. EXIDVER, not applicable to CICS/DOS-Entry, this keyword parameter 
indicates that the terminal* s unique ID sequence will be 
identified by BTAM-expanded ID verification. This parameter 
must be coded for any line on which there is a 3735. If devices 
which do not transmit unique ID sequences share the line with 
3735* s, the non-3735 operator must enter the terminal 
identification after the dial-up connection has been made. 

Note: These keyword parameters are valid only if the corresponding 
keyword parameters have been included in the DFHSG 
PROGRAM=TCP,ANSWRBK= (parameters) specification during system 
generation. 

LINSTAT: The LINSTAT='OUT OF SERVICE* operand indicates that the line 
is to be initiated with an "out of service" status. 

BSCODE: This operand is used to specify the type of communication code 
to be used for a given binary synchronous communication device. The 
applicable keyword parameters are EBCDIC, ASCII, and TRANSCODE. The 
default is BSCODE=EBCDIC. 

CONVTAB: This operand is used to specify the type of transmission 
code, and may be used in lieu of the BSCODE operand for binary 
synchronous devices. The applicable keyword parameters are: 

Extended Binary Coded Decimal Interchange Code 
American Standard Code for Information Interchange 
Six-bit transmission code 

ABB* code for the 7770 Audio Response Unit Model 3 
ABC code for the 7770 Audio Response Unit Model 3 

RDYMSG: Required when TRMTYPE=7770 is specified, this operand is used 
to specify the symbolic address of the ready message used by CICS to 
communicate with terminals attached to the 7770 Audio Response Unit. 
The ready message is defined through the DFHTCT TYPE=7770MSG macro 
instruction. (See the section "Define Digital Response Messages for 
the 7770 Audio Response Unit".) 

ERRMSG: Required when TRMTYPE=7770 is specified, this operand is used 
to specify the symbolic address of the error message used by CICS to 
communicate with terminals attached to the 7770 Audio Response Unit. 
The error message is defined through the DFHTCT TYPE=7770MSG macro 
instruction. (See the section "Define Digital Response Messages for 
the 7770 Audio Response Unit".) 

GENPOLL: GENPOLL=YES must be specified for a multipoint binary 
synchronous communication line if one or more of the polling sequences 
in the DFTRMLST (pointed to by the label specified in the LISTADR 
operand) is a general poll sequence. If this operand is used, the 
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POLLPOS operand must be included in each DFHTCT TYPE=TERMINAL 
specification associated with the line. For TRMTYPE=2980 and 
TRMTYPE=3270, GENPOLL=YES is a default specification. 

POOLCNT: Applicable only to the CICS/OS system, this operand is used 
to specify the number of Terminal Control Table line entries (TCTLE's) 
to be included in the pool of TCTLE's for a line group comprised of 
local 3270 Information Display Systems. The pool of TCTLE's is used 
by CICS to support concurrent operations on the BTAM local line group. 

The number of TCTLE's specified should reflect the expected activity 
On the local line group and the anticipated maximum number of concurrent 
requests. For a local line group containing printers, the number 
specified should be the actual number of printers plus one to avoid 
locking out any screen keyboards when all printers are busy. 

When a READ or WRITE for a particular 3270 is issued, CICS allocates 
the first available TCTLE from the pool. This TCTLE is freed when the 
operation at the device is complete. For WRITE operations at a printer, 
the operation at the device is considered complete when the printing 
operation is complete. 

CICS supports as many concurrent operations on the line group as 
there are TCTLE's in the pool. If no TCTLE is available to support a 
requested operation, the request remains pending until a TCTLE becomes 
available. 

For CICS/OS, local 3270 's can be arranged in line groups in any 
desired manner. 

TCTUAL: This operand is used to specify the length, in bytes (0-255) , 
of the Process Control Information field (PCI) for all terminal entries 
(TCTTE's) associated with this line. The default is TCTUAL=0. 

If fields of different (variable) lengths are desired, the TCTUAL 
value can be specified in one or more DFHTCT TYPE=TERMINAL macro 
instructions for terminals associated with this line. In any case, 
the PCI field is generated for each terminal after the last terminal 
entry of the last line. The address of the PCI field is located at 
TCTTECIA; the length is located at TCTTECIL. 

For CICS/OS, PCI fields of fixed length (15 bytes) and/or variable 
length (0-255 bytes) can be specified via the TCTUA operand of the 
DFHSG TYPE=INITIAL macro instruction. In the case of a fixed-length 
PCI field (the address of which is located at TCTTECI) , the TCTUAL 
operand need not be specified. In the case of a variable-length PCI 
field (the address of which is located at TCTTECIA) , the TCTUAL operand 
should be specified in the DFHTCT TYPE=LINE macro instruction and/or 
DFHTCT TYPE=TERMINAL macro instruction. 

OUTQ: Required in all TCAM input process queue Terminal Control Table 
line entries (TCTLE's), the symbolic name identifies the corresponding 
TCAM output process queue TCTLE. Multiple input process queues may 
reference the same output process queue. 

POOL: By specifying POOL=YES on the TCAM output process queue, the 
POOL feature is supported for that TCAM line. The user should analyze 
the restrictions prior to specifying the POOL feature. For further 
information concerning line pool restrictions, see the section 
"CICS/TCAM Interface Considerations". 
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QUEUEID: This optional operand is used to specify a unique user 
identification for the TCAM process queue. The identification is an 
unframed, one-byte hexadecimal number (00-FF) which is placed in both 
the input and output line entry at TCTLEQID to provide unique queue 
identification while executinq a user exit. 

DESCRIBE TERMINAL TYPES 

The types of terminals on the system are described to CICS by the 

symbol DFHTCT TYPE=TERMINAL 

macro instruction. The expansion of this macro instruction is the 
Terminal Control Table terminal entry (TCTTE) . These terminal 
definitions must immediately follow the corresponding line entry (DFHTCT 
TYPE=LINE) . The sequential terminals (TRMTYPE=CRLP, DISK, TAPE) support 
only one entry each. 

A DFHTCT TYPE=TERHINAL macro instruction must be coded for each 
terminal on a line. On sinqle dropped and multidropped terminals on 
non-switched lines, the DFHTCT TYPE=TERMINAL macro instruction must 
immediately follow the DFHTCT TYPE=LINE macro instruction. The DFHTCT 
TYPE=TERMINAL macro instruction entries must be contiguous for 
multidropped terminals on non-switched lines and for terminals in a 
terminal pool on switched lines. 

For TCAM, the user must specify a single TCTTE for the input process 
queue line. This may be considered to be a "dummy" TCTTE in that it 
does not relate to any physical terminal. On the output process queue 
line (TCTLE) , the user identifies each terminal to be associated with 
that line set. Therefore, if the user has ten terminals associated 
with a particular TCAM process queue, he must code eleven DFHTCT 
TYPE^TERMINAL macro instructions; one follows the input DFHTCT TYPE=LINE 
macro instruction while the remaining ten follow the output DFHTCT 
TYPE=LINE macro instruction. 

The following operands can be used in the DFHTCT TYPE=TERMINAL macro 
instruction: 

symbol DFHTCT TYPE=TERMINAL, * 

TRMIDNT=name, * 

TRMPRTY=number, * 

TRMMODL=number, character, * 

TRMTYPE=1030,1050, 1053,1 130, 2020, 2260, L2260, 2265, * 

2740, 2740/2760, 274 1C,2741E, 2770, 2780, 2980, * 

3275, 3277, L3277, 3284, L3284 ,3286, 13286,3735, 7770, * 

SYS/3,SYS/7,S360,CRLP,DASD,TAPE,TWX,U/R, * 

CLASS=(CONV, BATCH, VIDEO, HARDCOPY, BISYNC, AUDIO) , * 

LVUNIT=number, * 

LASTTRM=LINE,GACB,POOL, * 

TRMADDR=address,name, * 

TRMSTAT= (TRANSACTION, TRANSCEIVE, RECEIVE, » OOT OF SERVICE 1 ,* 

INPUT) , * 

COMPAT=NO, (number of characters, number of lines, * 

device type, model number), * 

FEATURE=(PTRADAPT,SELCTPEN,AUDALARM,COPY,BUFEXP, * 

DCKYBD,UCTRAN) , * 

P0LLPOS=number, * 

TRANSID=name, * 

STN2980=number, * 

TAB2980=number, * 

TIOAL=number, * 

TCTUAL=number 
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TRMIDNT: Used to supply a unique four-character symbolic identification 
to each terminal. The TRMIDNT parameter and the destination 
identification in the Destination Control Table, when applicable, must 
be the same. The identification supplied will be left justified and 
padded with blanks to four characters if less than four characters are 
supplied. This is necessary as the system always searches for a four 
character match when searching tables. This operand may be omitted if 
POOL=YES is included in the DFHTCT TYPE=LINE specification. 

TRMPRTY: Used to establish terminal priority. This decimal value 
(000-255) is used in establishing the overall transaction processing 
priority. (Transaction processing priority is equal to the sum of the 
terminal priority, transaction priority, and operator priority, not to 
exceed 255.) The default is TRMPRTY=0. 

TRMMODL: Specifies the model number of the terminal associated with 
this communication line. If the device is one of the following, this 
operand must be included in either the DFHTCT TYPE=LINE or DFHTCT 
TYPE=TERMINAL specification: 

1. Component of the 1050 Data Communication System 

2. 2740 Communication Terminal Model 2 

3. Component of the 2980 General Banking Terminal System 

4. Component of the 3270 Information Display System 

5. 2740 Communication Terminal with 2760 Optical Image Unit 

6. 2260 Display Station 

7. 2265 Display Station 

TRMMODL=1 is used to specify the 2980 Teller Station Model 1, 3275 
Display Station Model 1, 3277 Display Station Model 1, 3284 Printer 
Model 1, or 3286 Printer Model 1. TRMM0DL=1 is the default for the 
3270 Information Display System. 

TRMM0DL=2 is used to specify the 2740 Communication Terminal Model 
2, 2980 Administrative Station Model 2, 3275 Display Station Model 2, 
3277 Display Station Model 2, 3284 Printer Model 2, or 3286 Printer 
Model 2. 

TRMMODL=4 is used to specify the 2980 Teller Station Model 4. 

TRMMODL=5 is used to specify component polling of the keyboard for 
the 1050 Data Communication System using non-switched communication 
lines. Component selection character 5 (0B) must be coded in the 
polling list (DFTRMLST) . 

TRMMODL=6 is used to specify component polling of reader 1 for the 
1050 Data Communication System using non-switched communication lines. 
Component selection character 6 (0D) must be coded in the polling list 
(DFTRMLST) . 

TRMMODL=7 is used to specify (1) the 2740 Communication Terminal 
with 2760 Optical Image Unit, or (2) component polling of reader 2 for 
the 1050 Data Communication System using non-switched communication 
lines. Component selection character 7 (0E) must be coded in the 
polling list (DFTRMLST) . 

TRMMODL=0 is used to specify an input component for the 1050 Data 
Communication System. Common polling character (15) must be coded 
in the polling list (DFTRMLST) . TRMMODL=0 is the default" specification 
for a 1050 Data Communication System. 
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The TRMMODL=character operand is used to specify the applicable 
screen format for a 2260/2265 Display Station as follows: 

SPECIFICATION 

TRMMODL=A 
TRMMODL=B 
TRMMODL=C 
TRMMODL=D 
TRMM0DL=E 

For example, TRMMODL=A specifies a 2260 Display Station with a 6x40 
screen format. 

TRMTYPE: This operand is used to specify the terminal type if (1) the 
terminal type has not already been specified in the DFHTCT TYPE=LINE 
macro instruction, or (2) the user wishes to override the TRMTYPE 
specification in the DFHTCT TYPE=LINE macro instruction. 

CRLP is the card reader and line printer (a pair of sequential 
devices simulating a terminal) . DASD is the direct access device. 
TAPE is the magnetic tape device. A 1053 is a 1053 printer on a local 
or remote 2848 control unit. TWX is the Common Carrier Teletypewriter 
Exchange Terminal Station (Model 33/35) . U/R is a general term that 
refers to any reader, printer, or punch. 

CLASS: This operand is used to indicate the device classification 
associated with a particular line. The applicable keyword parameters 
are: 

Device with conversational type application 

Data collection type device 

Device with cathode ray tube 

Start/stop hard-copy device 

Binary synchronous device 

Audio response device 

LVUNIT: This operand is applicable only when TRMTYPE=L2260, 
TRMTYPE=L3277, TRMTYPE=L3284 , or TRMTYPE=L3286 is specified, or when 
TRMTYPE=1053 is specified for a local 2260 line. LVUNIT specifies a 
decimal number from 1 to N which is used to identify the local video 
unit. The maximum value of N for local 2260 is 25. For local 3270, 
N maximum is 32 (use of Assembler D restricts N to a maximum of 31) . 

For the CICS/DOS systems, the LVUNIT specification indicates the 
local video unit's relative position in the corresponding DFHTCT 
TYPE=SDSCI, LINELST=parameter specification. For the CICS/OS system, 
the LVUNIT specification indicates the local video unit's relative 
position in the concatenation of data definition (DD) statements for 
the corresponding DFHTCT TYPE=SDSCI specification. 

LASTTRM: This operand is used to indicate a "last terminal" condition. 
The applicable keyword parameters are: 

1. GACB, used for GAM only, identifies both the last terminal entry 
on a given line entry and the last terminal entry on a graphics 
attention control block. 

2. LINE, used for BTAM non-switched line processing (except local 
3270) , BGAM (if GACB conditions do not apply) , and TCAM (if 
POOL=YES has not been specified) . 
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3. POOL, used for BTAM switched-line processing, for the local 3270 
Information Display System, and for TCAM, identifies the last 
terminal in the pool. For TCAM, POOL is used if POOL=YES has 
been specified. 

TRMADDR: The TRMADDR=address operand specifies the device address 
associated with a given terminal and is required only for BTAM devices. 
(This operand is not required for some BTAM output devices; for example, 
a dial-up 2741.) For most non-switched lines, the hexadecimal addressing 
characters associated with the terminal must be specified. (This 
operand should not be used if the devices are local 2260' s or local 
3270's). For either binary synchronous devices or switched lines, the 
label of the BTAM DFTRMLST must be specified using the TRMADDR=name 
operand. 

Note: For a 3735, the BTAM DFTRMLST must be of the SWLST,AD type. For 
a TWX, TRMADDR is not required if ANSWRBK=TERMINAL is specified 
on the DFHTCT TYPE=LINE macro instruction. 

TRMSTAT: Specifies the type of activity that may occur at a given 
terminal. This terminal status is initially set in the TCTTE and is 
a combination of the processing status and the service status. Possible 
status designations are TRANSACTION, TRANSCEIVE, RECEIVE, INPUT and/or 
'OUT OF SERVICE 1 . 

A terminal with TRANSACTION status is used in the processing of 
transactions such as inquiries or order entries. A display station is 
normally classified as a TRANSACTION terminal. A hard-copy terminal 
to which no messages are sent without a terminal request and through 
which transactions are entered is a TRANSACTION terminal. If no other 
status designation is made, the terminal status defaults to TRANSACTION. 

A terminal with TRANSCEIVE status is a TRANSACTION terminal but one 
to which messages are sent automatically by the user. The automatic 
transaction initiation created by a transient data destination reaching 
a trigger level sets a condition in an appropriate Terminal Control 
Table terminal entry. If the terminal status is TRANSCEIVE and if 
there is no transaction at the terminal, Terminal Control initiates 
the user-defined task. This task is expected to send messages to the 
terminal. 

A terminal with RECEIVE status is one to which messages are sent 
but from which no input is allowed. An example of this type of terminal 
is one which is located in a remote location, such as a warehouse, is 
unattended, but may receive messages. 

Note; RECEIVE should be specified for a System/7 with the Station 

Control feature. This allows polling to be suspended until the 
System/7 is IPL'd by the host, at which time the status is 
changed to TRANSCEIVE. If the System/7 is IPL'd remotely, the 
master terminal must be used to change the terminal status to 
enable the System/7 to transmit. 

A terminal with INPUT status is one which can send messages to CICS 
but cannot receive messages from CICS. 

A terminal with an 'OUT OF SERVICE' designation is one which can 
neither receive messages nor transmit input. Such terminals are not 
polled by CICS. The 'OUT OF SERVICE' parameter can be used in 
combination with TRANSACTION, TRANSCEIVE, or RECEIVE; if such a 
combination is not specified, the terminal status defaults to 
TRANSACTION. 
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All terminals except the master terminal can be designated as 'OUT 
OF SERVICE 1 . When appropriate, the terminals can be placed IN SERVICE 
by the master terminal and polling is resumed. 

COMPAT: This operand is used to indicate that the 2260/2265 terminal 
or 1053 printer specified in the "device type" parameter is to be 
simulated on the 3270 Information Display System. The keyword 
parameters are positional and must be replaced by a comma if they are 
omitted. The default is COMPAT=NO. 

The "number of characters" parameter is used to specify the screen 
size of the 2260/2265 terminal. Applicable parameters are 240, 480, 
and 960. 

The "number of lines" parameter is used to indicate the number of 
lines applicable to the 2260/2265 terminal or to insert new line (NL) 
symbols into the 328 4/3286 printer output data stream where NL symbols 
are not provided by the user in the output data stream. Applicable 
parameter values are 6, 12, and 15. The default value for a 
960-character screen is 12. 

The "device type" parameter is used to specify either a 1053, 2260, 
L2260, or 2265 terminal. The default is 2260. Note that the 
specification COMPAT= (960, 15) results in an error condition since the 
2260 (assumed by default) cannot support 15 lines. 

The "model number" parameter is used to specify a model number for 
the 2260 terminal being simulated. This parameter provides an interface 
for any user-written application programs that currently test the 
TCTTEMN field before building device-dependent 2260 data streams. 

For further information concerning the use of the COMPAT operand, 
see the section "2260 Compatibility for the 3270". 

FEATURE: This operand is used to specify applicable features for the 
3270 Information Display System and corresponding 3284 Printer Model 
3 on the 3275 Display Station. 

FEATDRE=PTRADAPT specifies the Printer Adapter feature and 
corresponding 3284 Printer Model 3 on the 3275 Display Station. Note 
that a separate DFHTCT TYPE=TERMINAL macro instruction cannot be coded 
for the 3284 Printer Model 3 because the 3284 Model 3 shares the buffer 
of the 3275 Display Station. 

FEATURE=SELCTPEN specifies the Selector Pen feature for a 3275 
Display Station or a 3277 Display Station. 

FEATORE=AUDALARM specifies the Audible Alarm feature for a 3275 
Display Station or a 3277 Display Station. 

FEATURE=COPY specifies the Copy feature for a 3277 Display Station, 
3284 Printer, or 3286 Printer attached to a 3271 Control Unit. 

FEATURE=BUFEXP specifies the Buffer Expansion feature (RPQ835503) 
for the 2980 General Banking Terminal System. Applicable only to the 
first terminal entry of a control group, the BUFEXP parameter increases 
the station buffer size to 96 characters. 

FEATURE=DCKYBD specifies the typewriter keyboard and/or operator 
console keyboard for a 3275 Display Station or a 3277 Display Station. 
Both uppercase and lowercase data can be transmitted with either of 
these keyboards. 
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FEATURE=UCTRAN specifies translation of all lowercase data to 

uppercase. If FEATURE=UCTRAN is specified, the EBCDIC and/or ASCII 

parameter must be specified through the UCTRAN operand of the DFHSG 
PROGRAM=TCP macro instruction. 

For further information concerning the use of the FEATURE operand, 
see the section "2260 Compatibility for the 3270". 

POLLPOS: This operand is used to specify, as a decimal integer, the 
position (relative to 1) of the polling characters associated with this 
terminal in the DFTRMLST supplied for the line. 

TRANSID: The TRANSID operand is used to specify a four-character 
transaction code whose use is dependent upon the terminal type for 
which it has been specified. If the access method being used is TCAM, 
the TRANSID operand is applicable only to Terminal Control Table 
terminal entries associated with the TCAM output queue. 

For the 2740 Communication Terminal/2760 Optical Image Unit 
combination (TRMTYPE=2740,TRMMODL=7) , the TRANSID operand is used to 
specify the transaction code of the transaction that is to be initiated 
when input is received from the 2760 and there is no active task. If 
input is received from the 2740, the first four characters of the input 
data stream are used as the transaction code. 

For the 3735 Programmable Buffered Terminal, the TRANSID operand is 
used to specify the transaction code of the transaction that is to be 
initiated for a batch transmission initiated by the terminal operator. 
If an inquiry message is received from the 3735, the transaction code 
used consists of the first four characters following the inquiry header 
(NULL I NULL) . See Appendix G for an example of a user-written 3735 
transaction. 

For all other terminals, the TRANSID operand is used to specify the 
transaction code of a transaction that is to be initiated each time 
input is received from the terminal and there is no active task. If 
the TRANSID operand is omitted, the first four characters of the data 
passed in the TIOA, or, in the case of a formatted 3270 data stream, 
the four characters following the first Set Buffer Address (SBA) order 
sequence, are used as the transaction code unless a TRANSID 
specification has been made in a DFHPC TYPE=RETURN request issued by 
the previous transaction. The transaction code used is the one supplied 
by the last specification of the TRANSID operand in the DFHPC macro 
instruction. 

The TRANSID operand is required for the following terminals. 

1. 1030 Badge Reader 

2. 2740 Communication Terminal/2760 Optical Image Unit 
combination 

3. 3735 Programmable Buffered Terminal if batched input processing 
is required 

STN2980: This operand is used to specify the station for which the 
alternate station address and normal station address are to be generated 
for each terminal entry in the Terminal Control Table corresponding to 
a 2980 General Banking Terminal System. In response to a given STN2980 
specification, an appropriate (hexadecimal) alternate station address 
and normal station address are generated by CICS as follows: 
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Station 
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E5 


61 


Station 
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E6 


E2 


Station 
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E7 


E3 


Station 


9 


24 


E8 



For example, in response to a STN2980=0 specification, X , F4» is 
generated as the alternate station address and X*40' is generated as 
the normal station address. 

TAB2980: This operand is used to specify, as a single-digit hexadecimal 
value (0-F) , the number of tabs to the passbook area as defined by the 
user and physically (uniquely) set on the terminal. The default is 
TAB2980=0. 

TIOAL: Applicable only to terminals on binary synchronous lines, this 
operand is used to specify the minimum size of the Terminal Input/Output 
Area (TIOA) to be passed to a transaction by the Terminal Control 
program. If the -size of an input message exceeds the value specified 
in this operand, the size of the TIOA corresponds to the size of the 
message. 

TCTUAL: This operand is used to specify the length, in bytes (0-255), 
of the Process Control Information field (PCI) for this terminal. The 
default is the TCTUAL value specified in the DFHTCT TYPE=LINE macro 
instruction; if not specified in the DFHTCT TYPE=LINE macro instruction, 
the default is TCTUAL=0. 

DEFINE DIGITAL RESPONSE MESSAGES FOR 7770 AUDIO RESPONSE UNIT 

For CICS to communicate with an audio terminal (for example, the 
2721 Portable Audio Terminal) , two digital response messages (an error 
message and a ready message) must be defined in the Terminal Control 
Table for each line. This is accomplished by issuing the 

symbol DFHTCT TYPE=7770MSG, * 

MESSAGE=' message' 

macro instruction, which must immediately precede the DFHTCT TYPE=FINAL 
macro instruction. To avoid confusion, these messages should be unique; 
that is, these messages should not also be defined in user-written 
application programs. 

The ready message is used by CICS: 

1. In response to a valid Terminal Identification being entered 
subsequent to line connection. 

2. When the sign-on sequence has been completed. 

3. When a 7770 Audio Response Unit is connected to a line and no 
transaction is associated with the 7770. 

4. In response to a READ request if the request sequence was not 
a WRITE, READ. 

The error message is used by CICS: 
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1. In response to an invalid Terminal Identification being entered 
subsequent to line connection. 

2. When a valid Terminal Identification has been entered but (1) 
the terminal has an "out of service" status, or (2) the terminal 
has an "in service" status but the Terminal Identification has 
already b€en entered on another line. 

3. In response to an invalid Transaction Identification. 

4. In response to an error during the sign-on/sign-off sequence. 

5. If the input message is too long. 

6. If the transaction associated with the 7770 is abnormally 
terminated. 

7. If a 32-second timeout occurs, or if a five-second time out 
occurs while entering information required by CICS. 

MESSAGE: This operand is used to define digital response messages for 
the 7770 Audio Response Unit. These messages must be constructed in 
the form of hexadecimal constants, enclosed within single quotes, and 
may contain up to 48 hexadecimal digits (24 bytes) . The first two 
digits must contain binary zeros (00) to represent a one-byte "silence" 
track address on the 7770; subsequent digits may be used to represent 
up to 23 additional one-byte 7770 track addresses. For further details, 
see the publication C ompo nent Description 7770 Audio Response Unit 
Model 3 (GA27-2712) ." 

See Appendix B for an example of a typical digital response 
specification. 

SPECIFY END OF, TERMINAL CONTROL TABLE 

The end of the Terminal Control Table is indicated to the control 
system by the 

DFHTCT TYPE=FINAL 

macro instruction, which must be contained on the last control card 
for the Terminal Control Table assembly. An Assembler END card that 
includes the label DFHTCTBA must be provided by the user to end the 
assembly. 

TERMINAL CONTROL TABLE EXAMPLE 

Figure 2 illustrates the coding that is required to create a CICS 
Terminal Control Table. The terminal network described includes: 

1. One DASD sequential terminal 

2. Two 2260 Display Stations and one 1053 printer (local attachment) 

3. Two 2740 Telecommunication terminals with the Station Control 
feature 

4. Two 1050 Data Communication terminals (dial-up) 

Note: DFTRMLST macro definitions are required by BTAM devices. These 
entries should be coded immmediately preceding DFHTCT TYPE=LINE 
entries or immediately following DFHTCT TYPE=TERMINAL entries. 

To be applicable to CICS/OS, or if converting from CICS/DOS to 
CICS/OS, the following changes must be made to Figure 2: 

1. The DDNAME operand must be included unless the name specified 
in the DSCNAME operand is an acceptable default. 

2. The MODELST operand must be recoded as the MODE operand. 

3. The MACRF and NCP operands must be included unless the respective 
default values for these operands are acceptable. 
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4. The FLNNAME operand must be included to specify the name of the 
first communication line entry defined by the DFHTCT TYPE=LINE 
macro instruction. 

If converting from CICS/DOS to CICS/OS, operands applicable only to 
CICS/DOS need not be removed, since they are ignored by CICS/OS. 

For other examples of Terminal Control Table preparation, see 
Appendix B. 
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DFHTCT 
DFHTCT 



DFHTCT 



DFHTCT 



DFHTCT 



DFHTCT 



DFHTCT 



DFHTCT 



DFHTCT 



DFHTCT 



DFHTCT 



TYPE=INITIAL 

TYPE=SDSCI, 

DEVADDR=SYS001, 

DEVICE=2314, 

DSCNAME=DISKIN1 

TYPE=SDSCI, 

DEVADDR=SYS006 r 

DEVICE=2314, 

DSCNAME=DISK0T1 

TYPE=LINE, 

ACCMETH=SEQUENTIAL r 

TRMTYPE=DASD, 

ISADSCN=DISKIN1, 

0SADSCN=DISK0T1, 

INAREAL=80 

TYPE=TERMINAL, 

TRMIDNT=SAMB, 

TRMPRTY=11, 

TRMSTAT=TRANSCEIVE 

TYPE=SDSCI, 

CU=2848, 

DEVICE=L2260, 

LINELST= (037,038, 039) , 

SWITCH=NO, 

DSCNAME=DTF60L 

TYPE=LINE / 

ACCMETH=BTAM, 

TRMTYPE=L2260, 

DSCNAME=DTF60L, 

INAREAL=960 

TYPE=TERMINAL, 

TRMIDNT=L60A, 

TRMPRTY=64, 

LVUNIT=1 

TYPE=TERMINAL, 

TRMIDNT=GAMB, 

TRMPRTY=63, 

LVUNIT=2 

TYPE=TERMINAL, 

TRMIDNT=L600, 

TRMTYPE=1053, 

LVUNIT=3, 

TRMPRTY=32, 

TRMSTAT=RECEIVE, 

LASTTRM=LINE 

TYPE=SDSCI, 

CU=2703, 

DEVICE=2740, 

FEATURE= (STC,CHK) , 

LINELST=(027) , 

SWITCH=NO, 

DSCNAME=DTF40MD 



START OF TCT 

SPECIFY DATA SET CONTROL 

INFORMATION 



SPECIFY DATA SET CONTROL 
INFORMATION 



DASD LINE ENTRY 



DASD TERMINAL ENTRY 
DASD SYMBOLIC NAME 



SPECIFY DATA SET CONTROL 
INFORMATION 



LOCAL 2260 LINE ENTRY 



2260 TERMINAL ENTRY 

2260 SYMBOLIC NAME 

FIRST UNIT ON A DTF 

2260 TERMINAL ENTRY 

2260 SYMBOLIC NAME 

SECOND UNIT ON A DTF 

1053 TERMINAL ENTRY 



THIRD UNIT ON A DTF 



SPECIFY DATA SET CONTROL 
INFORMATION 



Figure 2 (Part- 1 of 2). Coding for terminal control table 
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PL2740L1 DFTRMLST OPENLST, (46 , 45) 

DFHTCT TYPE=LINE, 

ACCMETH=BTAM, 

TRMTYPE=2740, 

TRMMODL=1, 

DSCNAME=DTF40MD, 

BTAMRLN=1, 

LISTADR=PL2740L1, 

INAREAL=240, 

FEATURE=(SCONTROL,CHECKI 

DFHTCT TYPE=TERMINAL, 
TRMIDNT=T41L, 
TRMADDR=46, 
TRMPRTY=127, 
TRMSTAT=TRANSCEIVE 

DFHTCT TYPE=TERMINAL, 
TRMIDNT=T41K, 
TRMADDR=45, 
TRMPRTY=128, 
TRMSTAT=TRANSCEIVE, 
LASTTRM=IINE 

DFHTCT TYPE=SDSCI, 
CU=2703, 
DEVICE=1050, 
LINELST=(031) , 
SWITCH=YES, 
DSCNAME=DTF1050 
IDL1050 DFTRMLST DIALST,0 , (62 15, 6415) 
DIL1050A DFTRMLST DIALST, 7 , 1239876, (6 
DIL1050B DFTRMLST DIALST, 7, 1239875, (6 

DFHTCT TYPE=LINE, 

ACCMETH=BTAM, 
TRMTYPE=1050, 
DSCNAME=DTF1050, 
INAREAL=80> 
BTAMRLN=1, 
LISTADR=IDL1050, 
FEATORE= (AUTOANSR,AUTOCA 
POOLADR=T50POOL, 
ANSWRBK=TERMINAL 
T50POOL DFHTCT TYPE=TERMINAL, 
TRMIDNT=T50A, 
TRMADDR=DIL1050A, 
TRMPRTY=203, 
TRMSTAT=TRANSCEIVE 

DFHTCT TYPE=TERMINAL, 
TRMIDNT=T50B, 
TRMADDR=DIL1050B, 
TRMPRTY=204, 
TRMSTAT=TRANSCEIVE, 
LASTTRM=POOL 

DFHTCT TYPE=FINAL 

END DFHTCTBA 



POLL LIST TERMINAL 
2740 LINE ENTRY 



POLL LIST NAME 



NG) 



2740 TERMINAL ENTRY 
2740 SYMBOLIC NAME 
TERMINAL ADDRESS = L 



2740 TERMINAL ENTRY 
2740 SYMBOLIC NAME 
TERMINAL ADDRESS = K 



LAST TERMINAL ON LINE 
SPECIFY DATA SET CONTROL 
INFORMATION 



213) 
413) 



1050 LINE ENTRY 



POLL LIST NAME 
LL), 



1050 TERMINAL ENTRY 



1050 TERMINAL ENTRY 



LAST TERMINAL ON LINE 

END OF TCT 

POINT TO REQUIRED ENTRY LABEL 



Figure 2 (Part 2 of 2) . Coding for terminal control table 



FILE CONTROL TABLE (FCT) 

The File Control Table is used to describe to CICS any user data 
sets (files) that are processed by file management. (Note that 
sequential data sets should be defined as extrapartition destinations 
using the DFHDCT macro.) The DFHFCT macro instruction is used to 
generate entries in the table and to request the following services: 
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1. Set up the open list for the data sets to be used when 
initializing and terminating the system. 

2. Describe characteristics of the data sets, such as access method 
used, record characteristics, types of service allowed. 

3. Define use of the data set as a cross index and provide the 
information to locate the next data set via indirect access. 

4. Define the segments and segment sets of a record. 

The data control information for each data set is included in the 
DFHFCT macro instruction. The indirect access and segmenting services 
are mutually exclusive; the entry for one data set cannot specify both 
services. 

The following operands can be included in the DFHFCT macro 
instruction: 

DFHFCT TYPE=INITIAL, * 
SUFFIX=xx 

DFHFCT TYPE=DATASET, * 

DATASET=name, * 

ACCMETH=BDAM,TSAM,DL/I, * 
SERVREQ= (GET, PUT, UPDATE, NEWREC , INDACC, SEGMENT, BROWSE, * 

KEY,NOEXCTL) , * 

BLKKEYL=decimal value, * 

EXTENT=number, * 

CYLOFL=number, * 

INDAREA=symbolic name, * 

INDSIZE=number, * 

INDSKIP=YES, * 

MSTIND=YES, * 

NRECDS=number, * 

IOSIZE=number, * 

IOWORK=symbolic name, * 

DEVICE= (n,m) , * 

SRCHM=YES, number, * 

VERIFY=YES, * 

RELTYPE=DEC,HEX,BLK, * 

LRECL= (length, length) , * 

BLKSIZE= (length, length) , * 

RKP=number, * 

RECFORM= (format, characteristic, DCB record format), * 

OPEN=INITIAL, DEFERRED, * 
KEYLEN=length 

DFHFCT TYPE=INDACC, * 

OBJDSID=name, * 

IARLKP=number, * 

IALKFL=length, * 

IADADMI=RELREC,KEY, * 

IADIII=hexadecimal character, * 
DUPDSID=name 

DFHFCT TYPE=SEGHEAD, * 

SEGLENG=length, * 

INDDISP=number, * 
TSEGIND=BIT, DISPLACEMENT 

DFHFCT TYPE=SEGDEF, * 

SEGNAME=name, * 

SEGCHAR= (format, alignment) , * 
SEGLENG=length 
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DFHFCT TYPE=SEGSET, * 

SEGSET=name, * 

SEGNAME= (namel ,. . . ,nameN) 

DFHFCT TYPE=SEGLAST 

DFHFCT TYPE=FINAL 

DFHFCT TYPE=LOGICMOD 

ESTABLISH CONTROL SECTION FOR FILE CONTROL TABLE 

The control section into which the File Control Table is assembled 
is established by means of the 

DFHFCT TYPE=INITIAL, * 

SUFFIX=XX 

macro instruction, which must be coded as the first statement in the 
source deck used to assemble the File Control Table. 

SUFFIX: This operand specifies a two-character alphameric suffix (other 
than "NO 1 which is reserved) for the File Control Table being assembled. 
This suffix, if specified, is appended to the standard module name 
(DFHFCT) and is used to name the module on the linkage editor output 
library. If this operand is omitted, a suffix is not provided. 

DESCRIBE DATA SET FOR FILE MANAGEMENT 

The physical characteristics of a data set are described to CICS 
File Management by the 

DFHFCT TYPE=DATASET 

macro instruction. This macro instruction includes operands that 
provide information about the access method, record characteristics, 
and the types of service allowed for the data set. This information 
is used to generate a DTF for CICS/DOS or a DCB for CICS/OS. 

If the DL/I facility of the IBM Information Management System 
(IMS/360) is to be accessed under CICS/OS, the DFHFCT TYPE=DATASET 
macro instruction is used to provide information about Data Language/I 
(DL/I) data bases. In this case, DATASET and ACCMETH are the only 
operands required. Physical characteristics of the DL/I data bases 
need not be specified since they are specified during generation of 
IMS Data Base Descriptions (DBD's). 

The DFHFCT TYPE=DATASET macro instruction can include the following 
operands: 

DFHFCT TYPE=DATASET, * 

DATASET=name, * 

ACCMETH=BDAM, ISAM, DL/I, * 
SERVREQ= (GET, PUT, UPDATE, NEWREC ,INDACC, SEGMENT, BROWSE, * 

KEY,NOEXCTL) , * 

BLKKEYL=decimal value, * 

EXTENT=number, * 

CYLOFL=number, * 

INDAREA=symbolic name, * 

INDSIZE=number, * 

INDSKIP=YES, * 

MSTIND=YES, * 
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NRECDS=number, * 

IOSIZE=number, * 

IOWORK=symbolic name, * 

DEVICE=(n,m) , * 

SRCHM=YES, number, * 

VERIFY=YES, * 

RELTYPE=DEC,HEX,BLK, * 

LRECL= (length, length) , * 

BLKSIZE= (length, length) , * 

RKP=number, * 

RECFORM= (format, characteristic, DCB record format), * 

OPEN=INITIAL, DEFERRED, * 
KEYLEN=length 

DATASET: Specifies the symbolic data set name to be used as the File 
Control Table entry for a specific data set. This data set name can 
consist of from one to seven characters in the CICS/DOS systems or from 
one to eight characters in the CICS/OS system. Since this data set 
name is used when generating the operating system control block 
(DCB/DTF) , it must be the same as the DOS file name or the OS DDNAME 
used in the job control statement defining the data set. 

For a DL/I data base the DATASET operand must specify the same data 
base name as was specified in the Program Communication Block (PCB) 
statements of Program Specification Block (PSB) generation (PSBGEN) . 

ACCMETH: Specifies the method of organization for a specific data set. 
ACCMETH=ISAM, ACCMETH=BDAM , or ACCMETH=DL/I must be specified. 

SERVREQ: Used to define the types of service reguest that can be 
processed against the data set. The parameters that can be included 
are as follows: 

Records on this data set may be read. 

Records may be written on this data set. 

Records may be updated on this data set. UPDATE requires 

that GET and PUT also be specified. 

Records may be added to the data set. NEWREC requires 

that PUT also be specified. NEWREC must be specified 

for OS ISAM data sets with variable-length records if 

updating is to be performed. 

5. INDACC Data set is used as a cross index. If INDACC is 

specified, the DFHFCT TYPE=INDACC macro instruction must 
be coded immediately following this DATASET definition. 

6. SEGMENT Records are segmented. If SEGMENT is specified, the 

DFHFCT TYPE=SEGHEAD, DFHFCT TYPE=SEGDEF, DFHFCT 
TYPE=SEGSET, and DFHFCT TYPE=SEGLAST macro instructions 
must be coded immediately following this DATASET 
definition. 

7. BROWSE Records may be sequentially retrieved from the data set. 

8. KEY Records are to be retrieved by key from DAM data set. 

This parameter should be specified only if ACCMETH=BDAM. 

9. NOEXCTL Records are not to be placed under exclusive control 

when a read for update is requested. Unless this 
parameter is specified, a read-for-update will cause 
the record to be placed under exclusive control (within 
the CICS partition/region) . 

Note: INDACC and SEGMENT cannot both be coded for the same data set. 
A data set used as a cross-index data set may not be defined as 
blocked BDAM. 
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1. 


GET 


2. 


POT 


3. 


UPDATE 


4. 


NEWREC 



BLKKEYL: Specifies a decimal value from 1-255 which represents the 
physical key length for a direct access record. This operand must 
always be specified for ISAM data sets and DAM data sets with physical 
keys. If a DAM data set contains blocked records, and deblocking is 
to be performed by using a logical key (that is, a key embedded within 
each logical record) , the logical key length is specified by using the 
KEYLEN operand. If records are to be placed under exclusive control 
during update operations, the physical key may not exceed 225 bytes. 

EXTENT: Applicable only to the CICS/DOS systems, this operand 
represents the maximum number of extents that are specified for a data 
set. This operand is required if ACCMETH=ISAM. EXTENT=2 represents 
a minimum value (one for prime data area and one for cylinder index) . 
If ACCMETH=BDAM, the presence of the EXTENT operand indicates that 
relative addressing (as opposed to actual addressing) is being used 
and the RELTYPE operand must also be used. 

CYLOFL: Applicable only to the CICS/DOS systems, this operand is 
required only if ACCMETH=ISAM. It is used to specify the number of 
tracks per cylinder which are reserved for cylinder overflow records. 

INDAREA: This operand is applicable only if ACCMETH=ISAM and specifies 
the unique symbolic name which is used by the DFHFCT macro to 
automatically generate a main storage area (within the File Control 
Table) that will contain all or part of the cylinder index. This 
operand is required only if the cylinder index is to be processed in 
main storage. 

INDSIZE: This operand specifies the length (in bytes) of the cylinder 
index area specified in the INDAREA operand. The minimum number of 
bytes can be calculated as: 

(m+3) (keylength + 6) 

where "m" is the number of entries to be read into main storage at one 
time, 3 is the number of dummy entries, and 6 is an abbreviated pointer 
to the cylinder. If m is set to the number of prime data cylinders + 
1, all of the cylinder index is read into main storage at one time. 
This operand is applicable only if ACCMETH=ISAM and the INDAREA operand 
is specified. 

INDSKIP: Applicable only to the CICS/DOS systems, the INDSKIP=YES 
operand indicates that the index skip feature is to be used if index 
entries reside in main storage. This operand is applicable only if 
ACCMETH=ISAM and the INDAREA operand are specified. 

MSTIND: Applicable only to the CICS/DOS systems, the MSTIND-YES operand 
indicates that a master index exists for the ISAM data set. This 
operand is applicable only if ACCMETH=ISAM and should be specified only 
if a master index exists for the data set. 

NRECDS: This operand specifies the number of logical records in a 
block, and is called the blocking factor. This operand is applicable 
only to the CICS/DOS systems and only if ACCMETH=ISAM, and should be 
specified only if the records are blocked. For DOS ISAM data sets with 
variable-length records within fixed-length blocks, this number has no 
relation to the actual number of records within the block. However, 
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the number specified multiplied by the LRECL parameter must equal the 
actual block size on the data set. 

IOSIZE: This operand specifies the number of bytes in the main storage 
area used when adding records to an ISAM data set. This operand should 
be used only when SERVREQ=NEWREC is also specified. For CICS/DOS 
systems, this operand causes a static work area to be generated as part 
of the FCT entry for the data set being defined. For the CICS/OS 
system, the IOWORK operand must also be used to supply a symbolic name 
to be associated with the work area. For further details, refer to 
DTFIS generation in the publication, DOS S upervisor and I/O Macro s 
(GC24-5037) or ISAM data set processing in the publication, OS Data 
Manage men t Services (GC 26-3746). 

Note: Under CICS/DOS with multiple ISAM files, whenever NEWREC services 
are requested and some files specify IOSIZE while others do not, 
two ISAM logic modules will be link-edited into the system. To 
prevent this, specify IOSIZE for all ISAM files requesting NEWREC 
services. 

IOWORK: Applicable only to the CICS/OS-STANDARD system, this operand 
is used to specify the symbolic name of a main storage work area to be 
used by the access method when adding records to ISAM data sets. If 
the data set contains variable-length records, this operand must be 
specified. 

It is permissible for the same symbolic name to be specified in more 
than one data set definition, thus causing an area to be shared. CICS 
prevents the shared area from being used concurrently by more than one 
transaction. 

A static work area is generated within the FCT for each unique 
symbolic name encountered during FCT generation. The size of each area 
is equal to the largest IOSIZE specified for each symbolic name. 

DEVICE: Applicable only to the CICS/DOS systems, the DEVICE=(n,m) 
operand is used for both DAM and ISAM data sets. "n" and "m" specify 
2311, 2314, 2321, or 3330. For DAM, "n" specifies the device type on 
which the data set resides. ("m" does not apply to DAM.) For ISAM, 
"n" specifies the device type on which the prime data area (and overflow 
area if present) reside. For ISAM, "m" specifies the device type 
containing the high-level index. If this operand is omitted, the 
default is DEVICE= (2314,2314) . 

SRCHM: This operand is applicable only to DAM keyed data sets and 
provides for a multiple track search for keyed records. If this operand 
is omitted, multiple track search does not occur. 

For CICS/DOS systems, SRCHM=YES is the only allowable form of the 
operand. For the CICS/OS system, SRCHM=number is the only applicable 
form of the operand, where "number" represents the number of tracks or 
blocks to be searched. For the CICS/OS system, the default is SRCHM=0. 

For further details, see the SRCHM operand under DTFDA generation 
in the publication, DOS Supervisor a nd I/O Macros (GC24-5037) or BDAM 
data set processing in the publication, OS Data M anagement Services 
(GC26-3746) . 

VERIFY: The VERIFY=YES operand indicates that the user wants to check 
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the parity of disk records after they are written. If this operand is 
omitted, records are not verified after a write request. 

RELTYPE: This operand applies only to DAM data sets and specifies that 
relative addressing is being used in the block reference portion of 
the Record Identification field. If the RELTYPE operand is omitted, 
absolute addressing is assumed (that is, MBBCCHHR) . If RELTYPE=DEC, 
the zoned decimal format is being used. If RELTYPE=HEX, the hexadecimal 
relative track and record format is being used. If RELTYPE=BLK (CICS/OS 
only), relative block addressing is being used. For further details, 
see "Data Base Considerations" in the CICS. Application Programmer's 
Reference Manual (SH20-1047) . 

IRECL: Specifies the maximum length (in bytes) of the logical record. 
For DOS ISAM data sets with variable-length records within fixed-length 
blocks, this number has no relation to the actual length of any logical 
record. However, the number specified, multiplied by the NRECDS 
parameter, must equal the actual block size on the data set. This 
operand must always be specified. 

For CICS/DOS, this operand should contain only one value (parameter) . 
This value should not be enclosed within parentheses. 

If the user of CICS/OS wishes to have a LRECL value generated in 
the DCB, he must specify that value in the second parameter of the 
operand; for example, LRECL= (50,50) , where the first "50" pertains to 
the FCT and the second "50" pertains to the DCB. If the second 
parameter is not specified, the DCB is generated without a LRECL value. 
If the data set is BDAM organized, the second parameter should never 
be specified. 

NoiSi NRECDS=1 ,LRECL=blocksize, is not allowed. The most advantageous 
specification is NRECDS=2,LRECL= (blocksize/2) . 

BLKSIZE: Specifies the length (in bytes) of the block. If blocks are 
variable-length, the length specified should be the maximum block 
length. If the NEWREC or BROWSE operands are used for DAM fixed-length 
data sets with keys, BLKSIZE must be (LRECL + BLKKEYL) for unblocked 
records or (LRECL * BLOCKING FACTOR + BLKKEYL) for blocked records. 
If blocks are undefined, for CICS/OS the length specified should be 
the maximum block length, for CICS/DOS the length should be the maximum 
block length + 8. This operand must always be specified. 

For CICS/DOS, this operand should contain only one value (parameter) . 
This value should not be enclosed within parentheses. 

If the user of CICS/OS wishes to have a BLKSIZE value generated in 
the DCB, he must specify that value in the second parameter of the 
operand; for example, BLKSIZE= (250,250) , where the first "250" pertains 
to the FCT and the second "2 50" pertains to the DCB. If the second 
parameter is not specified, the DCB is generated without a BLKSIZE 
value. The DCB value (second parameter) should always specify the true 
block size while the FCT value (first parameter) may, for DAM data 
sets, include the BLKKEYL value. In no case should the first BLKSIZE 
value specified, be less than the actual blocksize of the data set. 
In DOS ISAM, if records are unblocked, the following MNOTE will be 
generated in the DTFIS: 0,'KEYLOC INVALID, PARAMETER IGNORED'. 

RKP: Specifies the starting position of the key field in the record 
relative to the beginning of the record (position zero for DAM and ISAM 
data sets except position one for DOS ISAM data sets) . With 
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variable-length records, this operand must include the four-byte LLbb 
field at the beginning of each logical record. This operand must always 
be specified for data sets that have keys within each logical record 
or when browsing. 

Note: SERVREQ=BROWSE requires embedded keys in the data field in DOS 
ISAM, therefore the RKP parameter is required. 

RECFORM: Describes the format and characteristics of records on the 
data set. If this operand is omitted, the default is UNDEFINED. 

For CICS/DOS, if NEWREC is specified for undefined records, BLKSIZE 
must include an additional eight bytes for the count field. 

The format of the data set is described using one of the following 
parameters: 

1. FIXED Records are fixed length. 

2. VARIABLE Records are variable length. 

3. UNDEFINED Records are of undefined length. 

The characteristic of the data set is specified using one of the 
following parameters: 

1. BLOCKED Records are blocked. 

2. UNBLOCKED Records are not blocked. 

If the user of CICS/OS wishes to have the record format specified 
in the DCB, he must specify that value in the third parameter of the 
operand; for example, RECFORM= (FIXED, BLOCKED, FBS) . If the third 
parameter is not specified, the record format is not specified in the 
DCB. 

Note : For CICS/OS ISAM data sets with BROWSE option specified, a DCB 
RECFM parameter of VB or FB is always generated regardless of 
whether or not the data set is blocked. 

OPEN: The OPEN operand is used to specify the initial status of the 
data set. OPEN=INITIAL causes the data set to be opened by System 
Initialization, while OPEN=DEFERRRED will not open the data set until 
the user indicates he wishes it opened by using the Master Terminal 
Open/Close service function or the use of a DFHOC macro instruction in 
an application program. If this operand is omitted, the default is 
OPEN=INITIAL. 

KEYLEN: The KEYLEN operand is used only to specify the length of the 
logical key for the deblocking of DAM data sets. This key is usually 
embedded and located through use of the RKP operand. The length of 
the recorded (physical) key for DAM and ISAM data sets is specified in 
the BLKKEYL operand, and may be different from the value specified for 
KEYLEN. This operand must always be specified when logical keys are 
used. 

DESCRIBE CROSS-INDEX DATA SET RECORD 

The record on a cross-index data set that points to the next data 
set to be read is described using the 

DFHFCT TYPE=INDACC 
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macro instruction. This macro instruction may also contain information 
regarding duplicate records which may be referenced by this index 
record, including a pointer to a duplicate data set which contains 
additional identifying information. If this macro instruction is used, 
the SEEVREQ operand of the DFHFCT TYPE=DATASET macro instruction must 
include GET and INDACC. For further information on indirect accessing, 
refer to "Data Base Considerations" in the CICS Application Programmers 
Reference Manual (SH20-1047) . 

The DFHFCT TYPE=INDACC macro instruction can include the following 
operands: 

DFHFCT TYPE=INDACC, 

OBJDSID=name, * 

IARLKP=number, * 

IALKFL=length, * 

IADADMI=RELREC,KEY, * 

IADIII=hexadecimal character, * 

DUPDSID=name 

OBJDSID: Specifies the name of the data set referenced by the 
cross-index data set record. This name can consist of from one to 
seven characters in the CICS/DOS systems or from one to eight characters 
in the CICS/OS system. This operand must always be specified. 

IARIKP: Specifies the relative location within the cross-index data 
set record of the Record Identification field which is to be used to 
access the object, data set. The displacement is relative to the 
beginning of the record (position zero) . This operand must always be 
specified. 

IALKFL: Specifies the length (in bytes) of the Record Identification 
field that is to be used to access the object data set. This operand 
must always be specified. 

IADADMI: Supplies the argument type (RELREC or KEY) for the deblocking 
of a record from a blocked BDAM data set. IADADMI=RELREC signifies 
that the deblocking technique is relative record. I ADADMI=KEY signifies 
that the deblocking technique is key. This operand can be used only 
if the data set (file) to which this index data set points is the 
primary (target) data set. If this operand is omitted, and if the data 
set to which this index data set points is a blocked BDAM data set, 
the entire block is returned to the user in the File Control area. 

IADIII: This operand is used to specify a one-byte user-assigned code 
which signifies that the data in the Record Identification field refers 
to a duplicate data set rather than the normal object data set. This 
code must be contained in the first position of the Record 
Identification field and must be different from any other data that 
would normally appear in this position. This operand must always be 
specified if a duplicates data set name is specified (DUPDSID) . 

DOPDSID: This operand is used to specify the identification for the 
duplicate data set associated with the cross-index data set. This 
identification can contain up to seven characters for CICS/DOS and up 
to eight characters for CICS/OS. This operand may be omitted if a 
duplicates data set does not exist. 
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DEFINE HEADER OF SEGMENTED RECORD 

If the records on a data set are segmented, the 

DFHFCT TYPE=SEGHEAD 

macro instruction defines for File Management the header portion (root 
or control segment) of a segmented record. TYPE=SEGHEAD is the first 
of four operands which must be coded to specify segmented records. 

The DFHFCT TYPE=SEGHEAD macro instruction includes the following 
operands: 

DFHFCT TYPE=SEGHEAD, * 

SEGLENG=length, * 

INDDISP=number r * 
TSEGIND=BIT, DISPLACEMENT 

SEGLENG: Specifies the length (in bytes) of the header portion (root 
segment) of the record. This operand must always be specified. 

INDDISP: Provides the displacement of the segment indicator field 
relative to the beginning of the record (position zero) . This operand 
must always be specified. 

TSEGIND: Specifies the type of segment indicator field (BIT or 
DISPLACEMENT) . The default is TSEGIND=BIT. 

DESCRIBE EACH SEGMENT OF A SEGMENTED RECORD 

Each segment of a segmented record is described by means of the 

DFHFCT TYPE=SEGDEF 

macro instruction. TYPE=SEGDEF must be coded for every segment in the 
record in the seguence in which it occurs within the record. Definition 
of the last segment must be followed by the TYPE=SEGLAST operand which 
must precede the coding of the TYPE=SEGSET operands to automatically 
generate SEGSET=ALL as the first segment pattern in the File Control 
Table. 

The DFHFCT TYPE=SEGDEF macro instruction includes the following 
operands: 

DFHFCT TYPE=SEGDEF, * 

SEGNAME=name, * 

SEGCHAR= (format, alignment) , * 
SEGLENG=length 

SEGNAME: Specifies the eight-character symbolic name (label) of the 
segment. This operand must always be specified. 

SEGCHAR: Indicates characteristics (format, alignment) of the segment. 
If the SEGCHAR operand is omitted, the defaults are FIXED format, BYTE 
alignment. If one characteristic is specified, both must be specified. 

The format of a segment is described using one of the following 
parameters: 
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1. FIXED r the segment is fixed length. 

2. VARIABLE, the segment is variable length. The first byte of 
the segment indicates the length of the segment. 

When a segment is brought into main storage, the alignment is 
described using one of the following parameters: 

1. BYTE, the segment has no alignment. 

2. HALF, the segment is halfword aligned. 

3. FDLL, the segment is fullword aligned. 

4. DOUBLE, the segment is doubleword aligned. 

SEGLENG: Specifies the length (in bytes) of the segment; up to 255 
bytes can be specified (the length of the largest segment allowed) . 
If the segment is variable length, this value represents the maximum 
length. This operand must always be specified. 

DESCRIBE SEGMENT SETS 

The pattern of segments for a particular data set is described using 
the 

DFHFCT TYPE=SEGSET 

macro instruction. As many segment sets as desired may be specified. 

The DFHFCT TYPE=SEGSET macro instruction includes the following 
operands: 

DFHFCT TYPE=SEGSET, * 

SEGSET=name, * 

SEGNAME= (namel ,. . . ,nameN) 

SEGSET: Specifies the eight-character symbolic name (label) assigned 
to a particular pattern of segments. This label is used in coding the 
DFHFC macro instruction when segment services are reguired. The label 
may be the same as one of the segment names specified previously in a 
SEGDEF macro instruction but must be different from any other SEGSET 
name specified. The label ALL should not be used since CICS 
automatically creates a universal segment set with this label. This 
operand must always be specified. 

SEGNAME: Specifies the name of each segment to be included in the 
segment set, in the sequence in which the segment occurs in the 
segmented record. SEGNAME must the same name as that specified in a 
previous DFHFCT TYPE=SEGDEF macro instruction. 

SPECIFY LAST SEGMENT SET 

The end of the segment definitions and the end of the segment set 
definitions is indicated by the 

DFHFCT TYPE=SEGLAST 

macro instruction, which must be coded immediately following the last 
macro segment definition (TYPE=SEGDEF) and immediately following the 
last segment set (TYPE=SEGSET) for a data set. This macro instruction 
generates SEGSET=ALL, which includes all the segments in the record, 
as the first entry in the segment set portion of the File Control Table. 
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SPECIFY END OP FILE CONTEOL TABLE 

The end of the File Control Table is indicated by the 

DFHFCT TYPE=FINAL 

macro instruction, which creates a dummy table entry to signal the 
table end. This macro instruction is the last statement before the 
Assembler END statement, except in the CICS/DOS systems where the user 
may also elect to code the DFHFCT TYPE=LOGICMOD macro instruction. The 
Assembler END statement must include the label DFHFCTBA. 

CREATE SUPERSET ISAM LOGIC MODULE (CICS/DOS only) 

A superset ISAM logic module can be assembled in the CICS/DOS systems 
by issuing the 

DFHFCT TYPE=LOGICMOD 

macro instruction as the last statement before the Assembler END 
statement. The resulting logic module meets all the processing 
reguirements for defined ISAM data sets with the following exception. 

If multiple ISAM data sets have been defined with the "add" function 
(SERVREQ=NEWREC) and some of the data sets have the "prime data in main 
storage" characteristic (IOSIZE=number) while other data sets do not, 
an additional logic module is reguired to support those data sets which 
do not have the "prime data in main storage" characteristic. The user 
can circumvent this situation by ensuring that ISAM data sets with the 
"add" feature are all defined either with or without the "prime data 
in main storage" characteristics (IOSIZE=number) . 

If the user is required to assemble an additional ISAM logic module, 
he is so notified in a series of diagnostic messages at the end of the 
File Control Table listing. Also included in these messages are the 
reguired parameter values he must specify to create a superset logic 
module. 

For further details concerning logic module preparation, see the 
CICS/DOS Operations Gu ide. 

FILE CONTROL TABLE EXAMPLE 

Figure 3 illustrates the coding that is reguired to create a File 
Control Table for three data sets. The first data set in the table is 
a cross-index data set that provides indirect access to a master data 
set and may reference a duplicate data set. The master data set 
reguires segmenting services. 
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DFHPCT TYPE=INITIAL 
DFHFCT TYPE=DATASET, 

DATASET=INDEX, 

ACCMETH=ISAM, 

SERVREQ=(GET, 

PUT, 

UPDATE, 

NEWREC, 

INDACC) , 

RECFORM= (FIXED, BLOCKED) , 

LRECL=37, 

BLKSIZE=370 



START OF FILE CONTROL TABLE 
TABLE ENTRY FOR AN ISAM 
DATA SET USED AS A CROSS- 
INDEX DATA SET FOR A DATA SET 
NAMED MASTER. 
THIS DATA SET MAY BE 
UPDATED AND ADDED TO. 



DFHFCT TYPE=INDACC, 

OBJDSID=MASTER / 

IARLKP=26, 

IALKFL=11, 

IADIII=FF, 
DUPDSID=DUPLICA 
DFHFCT TYPE=DATASET, 

DATASET=DUPLICA, 
ACCMETH=BDAM, 
LRECL=22, 
SERVREQ= (GET) , 
RECFORM= (FIXED, U 



THIS DATA SET REFERENCES * 

A DATA SET NAMED MASTER, * 

WHOSE KEY IS FOUND AT * 

POSITION 26 OF THIS * 

RECORD. IT IS 11 CHARACTERS. * 

IT MAY POINT TO A DUPLICATES * 
DATA SET NAMED DUPLICA. 

TABLE ENTRY FOR A BDAM * 

DUPLICATES DATA SET WHICH * 

CONTAINS KEYS TO THE MASTER * 

DATA SET. IT IS A READ-ONLY * 

DATA SET. * 
NBLOCKED) 



DFHFCT TYPE=DATASET, 

DATASET=MASTER, 

ACCMETH=ISAM, 

SERVREQ= (GET, 

PUT, 

UPDATE, 

NEWREC, 

SEGMENT) , 

RECFORM= (FIXED, BLOCKED) , 

LRECL=310, 

BLKSIZE=1550, 

RKP=11 



TABLE ENTRY FOR AN ISAM DATA 
SET WHICH MAY BE UPDATED AND 
ADDED TO, AND WHOSE RECORDS 
ARE SEGMENTED. 



DFHFCT TYPE=SEGHEAD, 

SEGLENG=2, 

INDDISP=2, 

TSEGIND=BIT 
DFHFCT TYPE=SEGDEF, 

SEGNAME=SEGMENT1, 

SEGCHAR= (FIXED, 

DOUBLE) , 

SEGLENG=50 
DFHFCT TYPE=SEGDEF, 

SEGNAME=SEGMENT2, 

SEGCHAR= (VARIABLE, 

HALF) , 

SEGLENG=70 



SEGMENT HEADER DESCRIPTION 



SEGMENT #1 OF THE RECORD IS 
A FIXED-LENGTH, DOUBLEWORD 
ALIGNED FIELD. 



SEGMENT #2 OF THIS RECORD IS 
A VARIABLE LENGTH HALFWORD 
ALIGNED FIELD WHOSE MAXIMUM 

LENGTH IS 70 BYTES. 



Figure 3 (Part 1 of 2) . Coding for file control table 
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DFHFCT TYPE=SEGDEF, SEGMENT #3 OF THE RECORD IS * 

SEGNAME=SEGMENT3, A FIXED-LENGTH UNALIGNED * 

SEGLENG=45 FIELD 

DFHFCT TYPE=SEGLAST END OF SEGMENT DEFINITIONS 
DFHFCT TYPE=SEGSET, * 

SEGSET=PATTERN1, * 

SEGNAME= (SEGMENT1 , SEGMENT2, SEGMENT3) 

DFHFCT TYPE=SEGLAST LAST SEGMENT ENTRY FOR MASTER 

DFHFCT TYPE=FINAL END OF FILE CONTROL TABLE 

DFHFCT TYPE=LOGICMOD CREATE DOS ISAM LOGIC MODULE 

END DFHFCTBA POINT TO REQUIRED ENTRY LABEL 

Figure 3 (Part 2 of 2) . Coding for file control table 

DESTINATION CONTROL TABLE (DCT) 

The Destination Control Table (DCT) is used to describe to CICS the 
destination name and certain other characteristics of data that is 
transient to CICS (that is, to be processed by the Transient Data 
Control program) . Entries are made to the DCT by coding the Destination 
Control Table macro instruction (DFHDCT) . 

Seguential extrapartition destinations are used for storing data 
external to the CICS partition/region or for retrieving data from 
outside the partition/region. Data stored for this purpose includes 
data received from terminals or other data created internally as the 
result of some transaction reguirement identified by a user-written 
program. Extrapartition data may be both input and output data and is 
processed using QSAM under CICS/OS or SAM under CICS/DOS. 

Destination Control Table macro instructions are also used to specify 
intrapartition destinations. A single data set is used as intermediate 
storage for data to be directed to multiple intrapartition data 
destinations. Intrapartition data may be ultimately either transmitted 
upon request to the destination terminal or retrieved sequentially from 
the temporary data set for other uses. The user can specify, through 
the Destination Control Table, that a task is to be created when a 
certain number of records (trigger level) has been accumulated for an 
intrapartition destination. 

Included in the Destination Control Table is the appropriate 
user-prepared data set control information for all resident 
extrapartition data sets. This data set control information must follow 
the DFHDCT TYPE=INITIAL macro instruction. The extrapartition data 
sets supported under CICS are: blocked, unblocked, fixed, or variable. 

CICS provides the capability, in conjunction with the Dynamic 
Open/Close facility, to have nonresident (transient) data set control 
blocks and associated input/output areas and logic modules. Main 
storage normally encumbered for these storage areas is therefore 
available to the dynamic main storage area until the use of the storage 
areas is required. Nonresident data set control blocks are defined 
through the combination of DFHDCT TYPE=INITIAL and DFHDCT TYPE=SDSCI 
macro instructions. 

Whether the specified destinations are extrapartition or 
intrapartition (or indirect destinations pointing to either 
extrapartition or intrapartition destinations) , the symbolic names of 
the destinations must be provided by the user. Refer to Appendix A 
for a listing of the required destination identification (DESTID) 
entries. 



93 



The following operands can be included in the Destination Control 
Table (DFHDCT) macro instruction: 

DFHDCT TYPE=INITIAL, * 

SUFFIX=xx, * 

TRNSUFX=(XX,.. .) , . * 
SEPASMB=YES,NO 

DFHDCT TYPE=SDSCI, * 

DSCNAME=name, * 

MODNAME=name, * 

DEVICE=1403, 1404,1443 ,1445,2311 ,2314, 3330, TAPE, * 

BLKSIZE=length, * 

DEVADDR=symbolic address, * 

RECFORM=FIXUNB,FIXBLK,VARUNB,VARBLK, * 

FILABL=STD,NO, * 

TYPEFLE=INPUT, OUTPUT, RDBACK, * 

RECSIZE=length, * 

REWIND=UNLOAD,NORWD, LEAVE, REREAD, * 

TPMARK=NO, * 

BUFNO=number, * 

ERROPT=SKIP, IGNORE, * 
SUFFIX=xx 



DFHDCT TYPE=EXTRA, 

DSCNAME=name, 
DESTID=name, 
OPEN=INITIAL, DEFERRED, 
RESIDNT=YES,NO 

DFHDCT TYPE=INTRA, 
DESTID=name, 
REUSE=YES,NO, 
TRIGLEV=number, 
DESTFAC=TERMINAL,FILE, 
TRANSID=name 



DFHDCT TYPE=INDIRECT, 
DESTID=name, 
INDDEST=name 



DFHDCT TYPE=FINAL 



ESTABLISH CONTROL SECTION FOR DESTINATION CONTROL TABLE 

The entry point and beginning address for the Destination Control 
Table being defined are established by the 

DFHDCT TYPE=INITIAL, 
SUFFIX=XX, 
TRNSUFX= (XX,...) , 
SEPASMB=YES,NO 

macro instruction. 

SUFFIX: Specifies a two-character alphameric suffix (other than 'NO 1 
which is reserved) for the Destination Control Table being assembled. 
This suffix, if specified, is appended to the standard module name 
(DFHDCT) and is used to name the module on the linkage editor output 
library. If this operand is omitted, a suffix is not provided. 
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TRNSUFX: Specifies a list of one- or two-character alphameric suffixes 
associated with nonresident data set control blocks. Any suffix 
appearing subsequently in the SUFFIX operand of the DFHDCT TYPE=SDSCI 
macro instruction must also appear in this list. These suffixes are 
used to punch the control cards for the CICS/DOS Linkage Editor 
(DFHLINK) or for the OS Linkage Editor (LINKEDIT) . Op to 255 suffixes 
can be specified. 

Not e: During link-edit of DFHDCT there is one unresolved ADCON in each 
"" phase created under direction of TRNSUFX in DFHDCT TYPE=INITIAL. 
This message does not imply an error. 

SEPASMB: The SEPASMB=YES operand is used to indicate that only data 
set control information is to be generated; that is, the DFHDCT 
TYPE=INITIAL, DFHDCT TYPE=SDSCI, and DFHDCT TYPE=FINAL macro 
instructions are the only DFHDCT macro instructions to be included. 
The default is SEPASMB=NO. 

SPECIFY DATA SET CONTROL INFORMATION 

The data set control blocks (DTF's in CICS/DOS; DCB*s in CICS/OS) 
are generated in response to the 

DFHDCT TYPE=SDSCI 

macro instruction. This macro instruction is needed only for 
extrapartition transient data and must have a DFHDCT TYPE=EXTRA macro 
instruction associated with it for resident data set control blocks. 
Note that all DFHDCT TYPE=SDSCI macro instructions must be issued 
immediately following the DFHDCT TYPE=INITIAL macro instruction and 
preceding any DFHDCT TYPE=EXTRA, DFHDCT TYPE=INTRA, or DFHDCT 
TYPE=INDIRECT macro instructions. 

The DFHDCT TYPE=SDSCI macro instruction can include the following 
operands: 

DFHDCT TYPE=SDSCI, * 

DSCNAME=name, * 

MODNAME=name, * 

DEVICE=1403, 1404, 1443, 14 45, 231 1,231 4,3330, TAPE, * 

BLKSIZE=length, * 

DEVADDR=symbolic address, * 

RECFORM=FIXUNB,FIXBLK,VARUNB,VARBLK, * 

FILABL=STD,NO, * 

TYPEFLE=INPUT, OUTPUT, RDBACK, * 

RECSIZE=length, * 

REWIND-UNLOAD, NORWD, LEAVE, REREAD, * 

TPMARK=NO, * 

BUFNO=number, * 

ERROPT=SKIP, IGNORE, * 
SUFFIX=XX 

DSCNAME: Specifies the data set control name. This name must be the 
same as that specified in the DSCNAME operand of the DFHDCT TYPE=EXTRA 
macro instruction and is limited to seven characters in CICS/DOS or 
eight characters in CICS/OS. For CICS/OS, the DSCNAME is also the 
DDNAME and DCBNAME. 

MODNAME: Applicable only to the CICS/DOS systems, this operand is used 
to specify the name of the logic module to be used to process the 
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transient data set. If this operand is omitted, a standard DOS name 
is generated for calling the logic module. 

This operand can be used in conjunction with the DOS Subset/Superset 
Logic Module facility to reduce the number of logic modules required 
to process sequential data sets (where supersetting is permissible) . 

DEVICE: Applicable only to CICS/DOS, this operand specifies the type 
of input/output device. Valid device types are: 1403, 1404, 1443, 
1445, 2311, 2314, 3330, and TAPE. This operand is ignored in CICS/OS; 
instead, the device specified through the data definition (DD) statement 
is used. 

BLKSIZE: Specifies the length (in bytes) of the block (maximum length 
for variable length records). For DOS disk output data sets, add eight 
bytes required by Logical IOCS for creation of the count field. 

DEVADDR: Applicable only to CICS/DOS, this operand specifies the 
symbolic unit address. This operand is not required for disk data sets 
when the symbolic address is provided via the CICS/DOS EXTENT card. 

RECFORM: Specifies the record format of the data set. Valid entries 
are: FIXONB, FIXBLK, VARUNB, and VARBLK. For CICS/DOS, the default 
is RECFORM=FIXUNB. For CICS/OS, no default is provided; the record 
format specified in the data definition (DD) statement is used. 

FILABL: Applicable only to CICS/DOS, this operand specifies the type 
of label on tape data sets. Valid entries are STD or NO. The default 
is FILABL=NO. 

TYPEFLE: Indicates whether the data set is an input or output data 
set. The default is TYPEFLE= INPUT. For CICS/OS, TYPEFLE=RDBACK 
specifies an input data set to be read backwards. 

Note: An extrapartition data set may be either INPUT or OUTPUT but 

not both. A system ABEND or unpredictable results may occur if 
output operations are specified for an INPUT data set or if 
input operations are specified for an OUTPUT data set. 

RECSIZE: Specifies the length (in bytes) of the record (maximum length 
for variable length records) . 

REWIND: Indicates the disposition of a tape data set. Valid entries 
are UNLOAD and NORWD for CICS/DOS, and LEAVE and REREAD for CICS/OS. 

TPMARK: Applicable only to CICS/DOS, the TPMARK=NO operand indicates 
that the writing of a tapemark at end of data set (file) is to be 
suppressed. 

BUFNO: Specifies the number of buffers to be provided. For CICS/DOS, 
any value other than 2 defaults to 1. For CICS/OS, any number up to 
255 may be specified; the default value is 1 . 
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ERROPT: Specifies the error option to be performed in the event of 
error. Valid parameters are SKIP and IGNORE. ERROPT=SKIP causes the 
block that caused the error to be skipped. ERROPT=IGNORE causes the 
block to be accepted. The default is ERROPT=IGNORE. 

SUFFIX: Specifies a one- or two-character alphameric suffix for the 
nonresident data set control block being generated. The use of this 
operand indicates that the data set control block being generated is 
nonresident. Nonresident data set control blocks reside on the 
Real-Time Relocatable Library (DFHRPL) under the unigue name DFHTRNxx, 
where "xx" is the suffix specified in this operand. The user-provided 
suffix characters must also be specified in the DFHDCT TYPE=INITIAL, 
TRNSUFX= (xx,. . .) list. 

For each data set control block generated via the DFHDCT TYPE=SDSCI, 
SUFFIX=xx macro instruction, the same suffixed name must be specified 
in the preparation of the Program Processing Table (DFHPPT TYPE=ENTRY, 
PR0GRAM=DFHTRNXX) . 

For further information on the above operands, refer to the 
publication DOS Su pervi sor and Input/Output Macros (GC24-5037) or the 
publication OS Su pervis or and Data Man agement M acro Instructions 
(GC28-66U7) . 

SPECIFY EXTRAPARTITION DESTINATIONS 

Destinations external to the system are specified using the 

DFHDCT TYPE=EXTRA 

macro instruction. This macro instruction must be coded once for every 
extrapartition destination. 

Extrapartition destinations that use nonresident data set control 
blocks are not reguired to be associated with a specific data set 
definition. When such destinations are opened, a one- or two-character 
suffix must be supplied to the Dynamic Open/Close program that indicates 
which nonresident data set control blocks are to be used for the 
destinations. 

The DFHDCT TYPE=EXTRA macro instruction includes the following 
operands: 

DFHDCT TYPE=EXTRA, * 

DSCNAME=name, * 

DESTID=name, * 

OPEN=INITIAL, DEFERRED, * 
RESIDNT=YES,NO 

DS.CNAME: Specifies the data set name the user must include in the 
DFHDCT TYPE=SDSCI macro instruction for destinations that use resident 
data set control blocks. This operand is not applicable for 
destinations that use nonresident data set control blocks. Nonresident 
data set control blocks are identified when the destination is opened. 

DESTID: Specifies the symbolic name of the extrapartition destination. 
The symbolic name is the same as that used in the transient data macro 
instruction (DFHTD) to specify the destination. Any destination 
identification of more than four characters is truncated on the right. 
Refer to Appendix A for a listing of the reguired destination 
identification entries. 
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OPEN: Applicable only to extrapartition destinations that use resident 
data set control blocks, this operand is used to specify how the data 
set associated with this destination is to be opened. OPEN=INITIAL 
indicates that the data set is to be opened during system 
initialization. OPEN=DEFERRED indicates that the user will open the 
data set during real-time execution of CICS. The default is 
OPEN=INITIAL for destinations that use resident data set control blocks, 

RESIDNT: Indicates whether this destination is to use resident or 
nonresident data set control blocks. The default is RESIDNT=YES. Those 
CICS/DOS extrapartition sequential disk data sets that are to be closed 
and re-opened by the dynamic Open/Close function of the Master Terminal 
Program must be defined as nonresident or records may be lost. , 

SPECIFY INTRAPARTITION DESTINATIONS 

Destinations for messages that are to be logged temporarily by CICS 
are specified using the 

DFHDCT TYPE=INTRA 

macro instruction. This macro instruction must be coded once for every 
intrapartition destination. 

The DFHDCT TYPE=INTRA macro instruction can include the following 
operands: 

DFHDCT TYPE=INTRA, * 

DESTID=name, * 

REUSE=YES,NO, * 

TRIGLEV=number, * 

DESTFAC=TERMINAL,FILE, * 
TRANSID=name 

DESTID: Specifies the symbolic name of the intrapartition destination. 
The symbolic name is the same as that used in the Transient Data macro 
instruction (DFHTD) to specify the destination. Any destination 
identification of more than four characters is truncated on the right. 
Refer to Appendix A for a listing of the required destination 
identification entries. 

If the ultimate destination of the data is a terminal and if 
automatic task initiation is associated with the destination, the name 
specified in the DESTID operand must be the same as the name specified 
in the TRMIDNT operand of the DFHTCT TYPE=TERMINAL macro instruction. 
The user may find it convenient to use the same naming convention for 
terminal destinations and data set destinations, regardless of whether 
automatic task initiation is requested. 

REUSE: REUSE=YES specifies that intrapartition storage tracks for this 
destination are to be released as they are read and returned to the 
pool of available tracks. REUSE=NO specifies that intrapartition 
storage tracks for this destination are not to be released until a 
Transient Data PURGE macro instruction is issued; the PURGE macro 
instruction causes all tracks associated with this DESTID to be 
released. The default is REUSE=YES. 

TRIGLEV: Specifies the number of data records (trigger level) to be 
accumulated for a destination before automatically requesting the 
creation of a task to process these records. The ultimate destination 
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is normally a data set or terminal. If the TRANSID operand has been 
used, and if no trigger level has been specified, TRIGLEV defaults to 
a value of 1. The maximum which may be specified is 32767. (If the 
ultimate destination is a 2741 Communication terminal, the task to be 
initiated is not initiated until that terminal receives data.) 

If TRIGLEV=0, automatic task initiation does not occur; the data 
records accumulate until some program, however initiated, is executed 
and issues a DFHTD TYPE=GET macro instruction to access the records. 
If the execution of a DFHTD TYPE=PUT macro instruction results in the 
trigger level being reached (or exceeded) for a non-terminal 
destination, and if either a "maximum tasks" or "short on storage" 
condition exists for CICS, the task to be automatically initiated is 
not initiated until a subsequent PUT to the same destination occurs 
with the stress condition no longer existing. 

DESTFAC: If TRANSID has been specified, DESTFAC specifies the type of 
destination (TERMINAL or FILE) that the queue represents. If no 
destination is specified, the default is DESTFAC=TERMINAL. 

If DESTFAC=TERMINAL, task initiation to process the queue is by 
Terminal Control. If DESTFAC=FILE, task initiation is by Transient 
Data Control. 

TRANSID: Provides identification for the transaction that is to be 
automatically initiated when the trigger level is reached. If this 
operand is omitted, the application program must initiate the read 
operation. 

SPECIFY INDIRECT DATA DESTINATIONS 

Indirect data destinations can be specified within the Destination 
Control Table using the 

DFHDCT TYPE=INDIRECT 

macro instruction. The indirect data destination does not point to an 
actual data set but instead points to another destination. 

For example, assume the user develops functional symbolic names for 
the destinations of several message types. These, in turn, may point 
to one actual destination. At a later time the user might choose to 
direct one of the message types to another destination. The user does 
not change his programs but only alters the indirect destination name. 

The DFHDCT TYPE=INDIRECT macro instruction can include the following 
operands: 

DFHDCT TYPE=INDIRECT, * 

DESTID=name, * 

INDDEST=name 

DESTID: Specifies the four-character symbolic name of a particular 
indirect destination. The symbolic name is the same as that used in 
the Transient Data macro instruction (DFHTD) . Refer to Appendix A for 
a listing of the required destination identification entries. 

INDDEST: Specifies the symbolic identification of an intrapartition 
or extrapartition destination. This identification must be the same 
as the DESTID of the actual destination. 
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TERMINATE ENTRIES FOR THE DESTINATION CONTROL TABLE 

Entries for the Destination Control Table are terminated by the 

DFHDCT TYPE=FINAL 

macro instruction. This macro instruction must be the last statement 
in the assembly of every Destination Control Table before the Assembler 
END statement. The Assembler END statement must include the label 
DFHDCTBA. 

NONRESIDENT EXTR APARTITION DATA SET DEFINITION 

The definition of nonresident extrapartition data sets is 
accomplished through use of the DFHDCT TYPE=INITIAL and DFHDCT 
TYPE=SDSCI macro instructions. The data set control blocks and 
associated input/output areas are generated and cataloged to the 
Real-Time Relocatable Program Library (DFHRPL) as a separate table for 
each nonresident data set control block to be used. There must be an 
entry in the Processing Program Table (PPT) for each nonresident data 
set control block. The format of the name is DFHTRNxx, where "xx" 
represents the suffix character (s) specified in the DFHDCT TYPE=SDSCI, 
SOFFIX=xx macro instruction. The PPT entry for these data set control 
blocks must include the RELOAD=YES operand. 

In CICS/OS, the necessary access methods are acquired when data sets 
are opened. Therefore references to transient access methods (logic 
modules) in the following discussion are applicable primarily to 
CICS/DOS. 

In the CICS/DOS systems, the logic modules for the nonresident data 
set control blocks may also be transient. If the use of nonresident 
logic modules is desired, the logic modules must be assembled and 
cataloged to DFHRPL prior to execution. The logic modules are assembled 
using the standard DOS SAM macro instructions and must be cataloged 
with the same program name generated by the nonresident data set control 
block for which it is to be used. The name can be found in the assembly 
of the data set control block. Unless otherwise specified in the DFHDCT 
TYPE=SDSCI macro instruction, this name is the standard DOS logic module 
name. 

The PPT entry for each nonresident logic module must include the 
RELOAD=YES operand. 

In CICS/DOS, if the DCT is generated to include the nonresident data 
set control block definitions, the logic modules for both the resident 
and nonresident data set control blocks are link edited into the DCT. 
To allow the logic modules to be transient, the DCT should be assembled 
including only the resident data set control block definitions (DFHDCT 
TYPE=SDSCI) . A separate assembly can then be accomplished to generate 
only the nonresident data set control blocks. To perform this 
operation, include a DFHDCT TYPE=INITIAL, TRNSUFX= (XX, . . .) , SEPASMB=YES 
macro instruction, followed by DFHDCT TYPE=SDSCI macro instructions 
for all nonresident data set definitions, followed by the DFHDCT 
TYPE=FINAL macro instruction. 

DESTINATION CONTROL TABLE EXAMPLES 

Figure 4 contains an example of the coding required to generate a 
Destination Control Table that uses resident data set control blocks. 



100 



DFHDCT TYPE=INITIAL 

DFHDCT TYPE=SDSCI, 

DSCNAME=DFHXTRA, 
DEVADDR=SYSLST, 
DEVICE=1403, 
RECFOEM=FIXUNB 

DFHDCT TYPE=EXTRA, 

DSCNAME=DFHXTRA, 
DESTID=CASH 

DFHDCT TYPE=INTRA, 
DESTID=GAMA 

DFHDCT TYPE=INTRA, 
DESTID=SAMA 

DFHDCT TYPE=INTRA, 
DESTID=DAMA, 
TRIGLEV=5, 
DESTFAC=TERMINAL, 
TRANSID=AOTO 

DFHDCT TYPE=FINAL 

END DFHDCTBA 



START OF DEST CONTROL TABLE 
SPECIFY DATA SET CONTROL INFO 
RELATED DESTINATION 
SYMBOLIC UNIT ADDRESS 
DEVICE TYPE 
RECORD FORMAT 
EXTRAPARTITION DESTINATION 

SYMBOLIC NAME 

INTRAPARTITION DESTINATION 
SYMBOLIC NAME 

SYMBOLIC NAME 

SYMBOLIC NAME 



TRANSACTION ID 

END OF DEST CONTROL TABLE 

POINT TO REQUIRED ENTRY LABEL 



Figure 4. DCT using resident data set control blocks 
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Figures 5 and 6 show how the generation of a DCT can include 
extrapartition destinations that use nonresident data set control 
blocks. Figure 5 shows a DCT with nonresident data set control blocks 
and resident logic modules. Figure 6 shows a DCT with nonresident data 
set control blocks and nonresident logic modules. 

DFHDCT TYPE=INITIAL, * 

TRNSUFX=(AA,BB,CC,DD) , * 
SUFFIX=22 

DFHDCT TYPE=SDSCI, * 

DSCNAME=TAPE1, * 

RECFORM=FIXBLK, * 

TYPEFLE=OUTPUT, * 

BLKSIZE=2000, * 

DEVADDR=SYS011, * 

DEVICE=TAPE, * 

BUFN0=2, * 

RECSIZE=200, * 
SUFFIX=:AA 

DFHDCT TYPE=SDSCI, * 

DSCNAME=TAPE2, * 

RECFORM=FIXBLK, * 

TYPEFLE=INPUT, * 

BLKSIZE=2000, * 

DEVADDR=SYS011, * 

DEVICE=TAPE, * 

BUFN0=2, * 

RECSIZE=200, * 
SUFFIX=BB 

DFHDCT TYPE=SDSCI, * 

DSCNAME=TAPE3, * 

RECFORM=FIXUNB, * 

BLKSIZE=1240, * 

TYPEFLE=INPUT, * 

DEVADDR=SYS011, * 

DEVICE=TAPE, * 
SUFFIX=CC 

DFHDCT TYPE=SDSCI, * 

DSCNAME=TAPE4, * 

RECFORM=FIXUNB, * 

BLKSIZE=1240, * 

TYPEFLE=OUTPUT, * 

DEVADDR=SYS011, * 

DEVICE=TAPE, * 
SUFFIX=DD 

DFHDCT TYPE=SDSCI, * 

DSCNAME=PRINT, * 

RECFORM=VARUNB, * 

BLKSIZE=121, * 

DEVADDR=SYSLST, * 
DEVICE=1403 

DFHDCT TYPE=EXTRA, * 

DSCNAME=PRINT, * 
DESTID=PRNT 

DFHDCT TYPE=EXTRA, * 

RESIDNT=NO, * 
DESTID=TAPE 

DFHDCT TYPE=FINA1 

END DFHDCTBA 

Figure 5. DCT using nonresident data set control blocks and resident 
logic modules 
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The assembly of the macro instructions contained in Figure 5 results 
in a Destination Control Table with suffix 22 (DFHDCT22) that contains 
one data set control block for the printer (TYPE=SDSCI, DESTID=PRNT) . 
When the output of this generation is link edited, the logic modules 
for tape and printer are automatically included, and the four tape data 
set control blocks are cataloged separately to DFHRPL as DFHTRNAA, 
DFHTRNBB, DFHTRNCC, and DFHTRNDD. 

The extrapartition destination (DESTID=TA?E) can be opened through 
the CICS Dynamic Open/Close program with any of the four suffixed data 
set control blocks (DFHTRNAA, DFHTRNBB, DFHTRNCC, or DFHTRNDD) . It 
can then be closed and reopened with any of the other nonresident data 
set control blocks. 

Program Processing Table (PPT) entries must be included for the four 
data set control blocks cataloged separately. PPT entries must include 
the RELOAD=YES operand. 

DFHDCT TYPE=INITIAL, * 

TRNSOFX=(AA,BB,CC,DD) , * 
SEPASMB=YES 

DFHDCT TYPE=SDSCI, * 

DSCNAME=TAPE1, * 

RECFORM=FIXBLK, * 

TYPEFLE=OUTPUT, * 

BLKSIZE=2000, * 

DEVADDR=SYS011, * 

DEVICE=TAPE, * 

BUFN0=2, * 

RECSIZE=200, * 
SUFFIX=AA 

DFHDCT TYPE=SDSCI, * 

DSCNAME=TAPE2, * 

RECFORM=FIXBLK, * 

TYPEFLE=INPUT, * 

BLKSIZE=2000, * 

DEVADDR=SYS011, * 

DEVICE=TAPE, * 

BUFN0=2, * 

RECSIZE=200, * 
SUFFIX=BB 

DFHDCT TYPE=SDSCI, * 

DSCNAME=TAPE3, * 

RECFORM=FIXUNB, * 

BLKSIZE=12U0, * 

TYPEFLE=INPUT, * 

DEVADDR=SYS011, * 

DEVICE=TAPE, * 
SUFFIX=CC 

DFHDCT TYPE=SDSCI, * 

DSCNAME=TAPE4, * 

RECFORM=FIXUNB, * 

BLKSIZE=1240, * 

TYPEFLE=OUTPUT, * 

DEVADDR=SYS011, * 

DEVICE=TAPE, * 
SUFFIX=DD 

DFHDCT TYPE=FINAL 

END DFHDCTBA 

Figure 6 (Part 1 of 2) . DCT using nonresident data set control 

blocks and nonresident logic modules 
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DFHDCT TYPE=INITIAL, * 

SUFFIX=YY 
DFHDCT TYPE=SDSCI, * 

DSCNAME=PRINT, * 

RECFORM=VARUNB, * 

BLKSIZE=121, * 

DEVADDR=SYSLST f * 

DEVICE=1403 
DFHDCT TYPE=EXTRA, * 

DSCNAME=PRINT, * 

DESTID=PRNT 
DFHDCT TYPE=EXTRA, * 

RESIDNT=NO, * 

DESTID=TAPE 
DFHDCT TYPE=FINAL 
END DFHDCTBA 

Figure 6 (Part 2 of 2) . DCT using nonresident data set control blocks 

and nonresident logic modules 

The result of the generation of the macro instructions contained in 
Figure 6 (Part 2 of 2) is a Destination Control Table with a suffix of 
YY (DFHDCTYY) . The DCT contains one data set control block for the 
printer (TYPE=SDSCI, DESTID=PRNT) and one logic module for the printer. 

The four data set control blocks for tape are generated by the 
assembly of the macro instructions contained in Figure 6 (Part 1 of 
2) . When the output of that assembly is link edited, the data set 
control blocks are cataloged as DFHTRNAA, DFHTRNBB, DFHTRNCC, and 
DFHTRNDD. However, the user must have cataloged the logic modules used 
by these four data set control blocks to DFHRPL using DFHLINK, and must 
have included entries in the PPT that specify the RELOAD=YES operand 
for those logic modules. 

When using the generated DCT of Figure 6, no storage is used for 
the data set control blocks or for the logic modules until the 
extrapartition destination (DESTID=TAPE) is opened via the CICS Dynamic 
Open/Close program (DFHOCP) . The Dynamic Open/Close program will ensure 
that only one logic module of the same name is in storage at any one 
time. If the logic module is not resident in the DCT, the Dynamic 
Open/Close program frees the storage associated with the logic module 
when the data set is closed. 

For further details concerning the use of the Dynamic Open/Close 
facility, see the discussion of dynamic open/close in the "Master 
Terminal" section and the "Dynamic Open/Close Function" section of this 
manual. 

PROGRAM CONTROL TABLE (PCT) 

The Program Control Table is the means for the user to describe the 
control information to be used by CICS for identifying and initializing 
a newly-arrived transaction. Task Control uses a portion of each PCT 
entry for the purpose of accumulating transaction statistics. This 
table is required by the control system to verify the incoming 
transaction, supply the transaction priority and security key, supply 
the length of the Transaction Work Area, and keep transaction 
statistics. 
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The following operands can be included in the DFHPCT macro 
instruction: 

DFHPCT TYPE=INITIAL, * 

SUFFIX=xx 

DFHPCT TYPE=ENTRY, * 

TRANSID=name, * 

TRNPRTY=decimal value, * 

TRANSEC=decimal value, * 

THASIZE=decimal value, * 

PROGRAM=name, * 

TPURGE=YES,NO, * 

SPURGE=YES,NO, * 
COMPAT=NO,FORMAT,FULLBUF 

DFHPCT TYPE=FINAL 

ESTABLISH CONTROL SECTION FOR PROGRAM CONTROL TABLE 

The control section into which the Program Control Table is assembled 
is established by the 

DFHPCT TYPE=INITIAL, * 

SUFFIX=xx 

macro instruction. This macro instruction must be coded as the first 
statement in the source deck used to assemble the Program Control Table. 

SUFFIX: Specifies a two-character alphameric suffix for the Program 
Control Table being assembled. This suffix, if specified, is appended 
to the standard module name (DFHPCT) and is used to name the module on 
the linkage editor output library. If this operand is omitted, a suffix 
is not provided. 

SPECIFY TRANSACTION CONTROL INFORMATION 

Transaction control information is provided to CICS program 
management services by the 

DFHPCT TYPE=ENTRY 

macro instruction. Included in this macro instruction is information 
on priority, security key, program identification, purge indicators, 
and size of the Transaction Work Area. 

The DFHPCT TYPE=ENTRY macro instruction includes the following 
operands: 

DFHPCT TYPE=ENTRY, * 

TRANSID=name, * 

TRNPRTY=decimal value, * 

TRANSEC=decimal value, * 

TWASIZE=decimal value, * 

PROGRAM=name, * 

TPtJRGE=YES,NO, * 

SPURGE=YES,NO, * 
COMPAT=NO,FORMAT,FULLBUF 

TRANSID: Used to specify the four-character identification assigned 
to the individual transaction. Note that TRANSID=DISC should not be 
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specified if terminals are to be supported on switched lines. For 
further details concerning the use of terminals on switched lines, see 
the CICS Terminal Operator 1 s Guide. 

TRNPRTY: Used to define the transaction priority. This three-position 
decimal value (000-255) is used in establishing the overall transaction 
processing priority. (Transaction processing priority is egual to the 
sum of the terminal priority, transaction priority, and operator 
priority, not to exceed 255.) If this operand is omitted, the default 
is TRNPRTY=001. 

TRANSEC: Used to define the transaction security, the TRANSEC parameter 
is a three-position decimal value with a range 001 through 024. The 
default is TRANSEC=001. 

TWASIZE: Used to define the Transaction Work Area reguired. A 
five-position decimal value that determines the size (in bytes) of the 
Transaction Work Area to be acguired for this transaction. Refer to 
Appendix A for the minimum values that must be specified for programs 
provided by CICS. The default is TWASIZE=0. 

PROGRAM: Used to define the initial program identification; this 
operand specifies the name of the program to which control is to be 
given to process this transaction. 

TPURGE: Used to set the terminal error purge indicator. TPURGE=YES 
indicates that the terminal error purge indicator is to be set to allow 
the transaction to be purged when a terminal error occurs. The default 
is TPURGE=NO. 

SPURGE: Used to set the system stall purge indicator. SPURGE=NO 
indicates that the transaction is not purgeable when a system stall 
condition is detected. The default is SPURGE=NO. 

COMPAT: Used to flag those transactions that are to be run in 2260 
compatibility mode on the 3270 Information Display System. The default 
is COMPAT=NO. 

COMPAT=FORMAT indicates that the transaction is to be run in FORMAT 
mode; COMPAT=FULLBUF indicates that the transaction is to be run in 
FULLBUF mode. For a discussion of FORMAT and FULLBUF modes of 
compatibility operation, see the section "2260 Compatibility for the 
3270". 

SPECIFY END OF PROGRAM CONTROL TABLE 

The end of the Program Control Table is indicated by the 

DFHPCT TYPE=FINAL 

macro instruction, which is the last statement in the assembly of the 
Program Control Table before the Assembler END statement. This macro 
instruction creates a dummy entry to signal the table end. The 
Assembler END statement must include the label DFHPCTBA. 
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PROGRAM CONTROL TABLE EXAMPLE 

Figure 7 illustrates the coding that is required to create a Program 
Control Table. The transactions include: 

1. Three transactions of a higher priority than the default priority 

(TRNPRTY=1 is the default) 

2. Two transactions with security key protection 

3. Total of nine transactions 

See Appendix A for a list of all the entries required to create a 
Program Control Table. 

DFHPCT TYPE=INITIAL 

DFHPCT TYPE=ENTRY, * 

TRANSID=C0B1, * 

TWASIZE=64, * 
PR0GRAM=C0BPGM1 

DFHPCT TYPE=ENTRY, * 

TRANSID=C0B2, * 

TRNPRTY=100, * 

TRANSEC=10 r * 
PR0GRAM=C0BPGM2 

DFHPCT TYPE=ENTRY, * 

TRANSID=C0B3, * 

TWASIZE=100, * 

TRANSEC=5, * 

PR0GRAM=C0BPGM3, * 
TPURGE=YES 

DFHPCT TYPE=ENTRY, * 

TRANSID=C0B4, * 

PR0GRAM=C0BPGM4, * 
TPURGE=YES 

DFHPCT TYPE=ENTRY, * 

TRANSID=CSAC, * 

TRNPRTY=5, * 

TWASIZE=40, * 
PROGRAM=DFHACP 

DFHPCT TYPE=ENTRY r * 

TRANSID=CSMT, * 

TWASIZE=160, * 
PROGRAM=DFHMTPA 

DFHPCT TYPE=ENTRY, * 

TRANSID=CSST, * 

TWASIZE=100, * 
PROGRAM=DFHMTPA 

DFHPCT TYPE=ENTRY, * 

TRANSID=CSTA, * 

TWASIZE=000, * 
PROGRAM=DFHTAJP 

DFHPCT TYPE=ENTRY, * 

TRANSID=CSSN, * 

TRNPRTY=99, * 

TWASIZE=000, * 

PROGRAM=DFHSNP, * 
SPURGE=YES 

DFHPCT TYPE=ktNAL 

END DFHPCTBA 

Figure 7. Coding for program control table 
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PROCESSING PROGRAM TABLE (PPT) 

The Processing Program Table provides a means for the user to 
describe to Program Control the control information concerning the 
processing programs. In addition. Program Control uses portions of 
each table entry to retain certain information for maintaining control 
of the user's programs and to capture specified program statistics. 

This table is reguired by CICS to verify the processing program 
identification, to keep count of the number of transactions using that 
program, to maintain the address of the processing program, to 
communicate to CICS the type of load used for the program, to maintain 
the direct access address and size of the program, and to maintain 
statistics on the processing program. 

The Processing Program Table macro instruction (DFHPPT) specifies 
processing programs to be recognized by CICS. The following operands 
can be included in the DFHPPT macro instruction: 

DFHPPT TYPE=INITIAL, * 

SUFFIX=xx 

DFHPPT TYPE=ENTRY, * 

PROGRAM=name, * 

PGMLANG=ASSEMBLER, COBOL, PL/I, * 

RES=YES,NO, * 
RELOAD=YES,NO 

DFHPPT TYPE=FINAL 

Those programs most often used during execution of CICS should be 
specified first during preparation of the Processing Program Table. 

ESTABLISH CONTROL SECTION FOR PROCESSING PROGRAM TABLE 

The control section into which the Processing Program Table is 
assembled is established by the 

DFHPPT TYPE=INITIAL, * 

SOFFIX=xx 

macro instruction, which must be coded as the first statement in the 
source deck used to assemble the Processing Program Table. 

SUFFIX: Specifies a two-character alphameric suffix for the Processing 
Program Table being assembled. This suffix, if specified, is appended 
to the standard module name (DFHPPT) and is used to name the module on 
the linkage editor output library. If this operand is omitted, a suffix 
is not provided. 

DESCRIBE PROCESSING PROGRAMS 

A specific processing program is described to CICS program management 
services by the 

DFHPPT TYPE=ENTRY 

macro instruction. Included is information on the program name and 
the type of program. 

The DFHPPT TYPE=ENTRY macro instruction includes the following 
operands: 
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DFHPPT TYPE=ENTRY, * 

PROGRAM=name, * 

PGMLANG=ASSEMBLER, COBOL, PL/I, * 

RES=YES,NO, * 
RELOAD=YES,NO 

PROGRAM: Specifies the program identification, up to eight characters 
in length. The indicated program must have been previously link edited 
into the Real-Time Relocatable Program Library (DFHRPL) . 

PGMLANG: Specifies the type of program. The default is 
PGMLANG= ASSEMBLER. 

RES: Used to indicate whether or not the program is to be made resident 
in main storage when CICS is initialized. In the CICS/DOS-ENTRY system, 
the designated programs become permanently resident, and the size of 
dynamic storage (subpool 0) is reduced. For the CICS/DOS-STANDARD and 
CICS/OS-STANDARD systems, the designated programs are "packed" into 
the high portion of the user's dynamic main storage. The default is 
RES=NO. 

RELOAD: RELOAD=YES indicates that a fresh copy of the program is to 
be loaded by the Program Control program each time a load reguest for 
that program is issued. A Storage Control FREEMAIN, rather than a 
Program Control DELETE, must be used to free the storage. The default 
is RELOAD=NO. 

If the Dynamic Open/Close program is to be used, RELOAD=YES must be 
specified in each PPT entry that defines a nonresident data set control 
block. 

RELOAD=YES must also be specified for all CICS/DOS transient logic 
modules. The Dynamic Open/Close program maintains a use count for the 
logic modules to ensure that only one copy is in main storage at any 
one time. If the logic module is resident in the Destination Control 
Table, no entry is necessary in the PPT. In the DOS-ENTRY system, 
storage for the program is obtained from subpool 0. 

SPECIFY END OF PROCESSING PROGRAM TABLE 

The end of the Processing Program Table is indicated to the control 
system by the 

DFHPPT TYPE=FINAL 

macro instruction, which is the last statement in the assembly of the 
Processing Program Table before the Assembler END statement. This 
macro instruction creates a dummy entry to signal the table end. The 
Assembler END statement must include the label DFHPPTBA. 

PROCESSING PROGRAM TABLE EXAMPLE 

Figure 8 illustrates the coding that is required to create a 
Processing Program Table. The programs include: 

1. Four Assembler language programs, one of which is resident 

2. Four ANS COBOL programs 
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See Appendix A for a list of all the entries required to create a 
Processing Program Table. 

DFHPPT TYPE=INITIAL 

DFHPPT TYPE=ENTRY, * 

PR0GRAM=C0BPGM1, * 

PGMLANG=COBOL 
DFHPPT TYPE=ENTRY, * 

PR0GRAM=C0BPGM2, * 

PGMLANG=COBOL 
DFHPPT TYPE=ENTRY, * 

PR0GRAM=COBPGM3, * 

PGMLANG=COBOL, * 

RELOAD=YES 
DFHPPT TYPE=ENTRY, * 

PR0GRAM=C0BPGM4, * 

PGMLANG=COBOL 
DFHPPT TYPE=ENTRY, * 

PROGRAM=DFHACP 
DFHPPT TYPE=ENTRY, * 

PROGRAM=DFHTAJP 
DFHPPT TYPE=ENTRY, * 

PROGRAM=DFHMTPA 
DFHPPT TYPE=ENTRY, * 

PROGRAM=DFHSNP 
DFHPPT TYPE=FINAL 
END DFHPPTBA 

Figure 8. Coding for processing program table 

SYSTEM SERVICE TABLES 

The system service tables (optional) provide the user with increased 
control over the operation of CICS. The system service tables are: 

1. Sign-on Table that contains the operator security and priority 
data to permit an operator to sign on the system. 

2. Terminal List Tables that contain, by groups, the identification 
of terminals that are related logically; for example, the 
terminals in a remote location or all terminals whose operators 
are under the control of a supervisor. A supervisor, through 
his table, may alter the status of a terminal under his control. 
For example, he could place a terminal in an out-of-service 
condition. 

The Sign-on Table and the Terminal List Tables reside on a direct 
access storage device and are called into main storage as required. 
The use of a Sign-on Table or a Terminal List Table requires that 
PCPLOAD=YES be specified for DFHSG PROGRAM=PCP macro instruction. Refer 
to the CICS Terminal Operator's Guide for the terminal operator 
procedure in the use of the system service tabLes and programs. 

SIGN-ON TABLE (SNT) 

The Sign-on Table provides the means for permanently retaining 
terminal operator data. It is accessed when a terminal operator 
initiates the sign-on procedure. 

During the sign-on procedure, the name of the terminal operator is 
entered at the terminal and is used to locate the appropriate operator 
entry in the table. The operator entry in the table contains data used 
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to verify the operator name and to establish a priority and a security 
key for the transactions which the operator subsequently enters. 

The priority value related to the operator is used to develop the 
task priority for processing a transaction. The operator's security 
key is used in a security check of all transactions subsequently 
entered. The security key which is placed in the appropriate Terminal 
Control Table entry for the operator is matched with the transaction 
security contained in the transaction's Program Control Table (PCT) 
entry. 

If the operator security key contains any position that matches the 
security value in the PCT entry, the transaction is accepted. 
Otherwise, a security check has occurred and the transaction is 
terminated. A security key of 1 is the default option in the creation 
of the Sign-on Table, the Program Control Table, and the Terminal 
Control Table; this value is present in the Terminal Control Table 
until altered by a sign-on procedure. The security key default option 
allows transactions with a transaction security of 1 to be entered into 
the system by the operator without the sign-on procedure. 

The Sign-on Table macro instruction (DFHSNT) specifies the terminal 
operator data for the users of CICS. A DFHSNT entry should be present 
in the Sign-on Table for each terminal operator who is expected to sign 
on. 

The Sign-on Table must be assembled, link edited with the name 
DFHSNT, and represented in the Processing Program Table (PPT) . 

The following operands can be included in the DFHSNT macro 
instruction: 

DFHSNT TYPE=INITIAL 

DFHSNT TYPE=ENTRY, * 

OPNAME='operator name', * 

PASSWRD=password, * 

OPIDENT=operator identification, * 

SCTYKEY=(n1,.. . ,n24) , * 
OPPRTY=operator priority 

DFHSNT TYPE=FINAL 

Establish Sign-o n Table Control Sect ion 

The control section into which the Sign-on Table is assembled is 
established by the 

DFHSNT TYPE=INITIAL 

macro instruction, which must be coded as the first statement in the 
source deck used to assemble the Sign-on Table. 
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Desc r ibe Terminal Ope rato rs 

Each terminal operator is described to CICS through an entry in the 
Sign-on Table. These entries are made by issuing the 

DFHSNT TYPE=ENTRY 

macro instruction. included in this macro instruction is information 
on password, operator identification, security key, and operator 
priority. 

The DFHSNT TYPE=ENTRY macro instruction includes the following 
operands: 

DFHSNT TYPE=ENTRY, * 

OPNAME='operator name', * 

PASSWRD=password, * 

OPIDENT=operator identification, ' * 

SCTYKEY=(n1,...,n24) , * 
OPPRTY=operator priority 

OPNAME: Specifies the name of the terminal operator for this table 
entry. The operator name may be 1 to 20 characters long and must be 
unique for each entry. The operator name in this entry must be matched 
exactly by the operator name entered in the sign-on procedure. 

PASSWRD: Specifies a four-character password (identification) created 
by the user. The password entered by a terminal operator as a part of 
the sign-on procedure must be matched exactly by the password in the 
operator's Sign-on Table entry. Passwords may be unique to each 
operator or the same for a logical group of operators. 

OPIDENT: Used to specify the three-character operator identification 
code assigned by the user to each operator. This code is placed in 
the appropriate Terminal Control Table terminal entry (TCTTE) when the 
operator signs on so that the identity of the operator is known to 
CICS. This operator identification is made available to the master 
terminal when a security violation is detected. 

SCTYKEY: Specifies one or more decimal security-key values from 1 to 
24. The security key for a terminal operator is comprised of those 
values which are to be matched with the transaction security of an 
appropriate program control table entry. The security key may be built 
with from 1 to 24 individual values. Each decimal value in the range 
of 1 to 24 specified in the operand of the SCTYKEY keyword has a 
corresponding bit position in a three-byte SCTYKEY field. The presence 
of each value in the operand causes the corresponding relative bit 
position to be set on. 

The transaction security in a Program Control Table entry is 
specified as only one of the possible 24 individual values. The same 
value must be contained in the operator's security key to allow the 
operator to process that transaction. The operator's security key is 
not limited to just one value and likely contains several values* 

The default is SCTYKEY=1. It will also be a value whether or not 
it is specified. 

OPPRTY: Specifies a decimal operator priority value from to 255. 
An operator priority is assigned optionally by the user and is used in 
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developing the task processing priority for each transaction. The 
default is OPPRTY=0. 

Specify End of Si gn- on Table 

The end of the Sign-on Table is indicated by the 

DFHSNT TYPE=FINAL 

macro instruction, which is the last statement in the assembly of the 
Sign-on Table before the Assembler END statement. This macro 
instruction creates a dummy entry to signal the table end. The 
Assembler END statement must include the label DFHSNTBA. 

Sigjiz2n Table Example 

Figure 9 contains an example of coding for the Sign-on Table. In 
this example, there are two cases of the operator name being actual 
names and one instance of the name being a function. The first operator 
has access to transactions whose transaction securities are 1,2,7, or 
24. The other two operators have access to the same transactions as 
the first plus additional transactions. The second operator has a 
default priority of zero. 

DFHSNT TYPE=INITIAL 

DFHSNT TYPE=ENTRY, * 

OPNAME=»DON GIBSON 1 , * 

PASSWRD=DIST, * 

OPIDENT=DG, * 

SCTYKEY= (1,2,7,24) , * 
OPPRTY=128 

DFHSNT TYPE=ENTRY, * 

OPNAME=»R. J. JONES', * 

PASSWRD=DIST, * 

OPIDENT=RJJ, * 
SCTYKEY=(1,2,7,9,24) 

DFHSNT TYPE=ENTRY, * 

OPNAME=» MASTER TERMINAL V, * 

PASSWRD=MAST, * 

0PIDENT=MT1, * 

SCTYKEY=(1,2,3,4,7,9,24) , * 
OPPRTY=255 

DFHSNT TYPE=FINAL 

END DFHSNTBA 

Figure 9. Coding for sign-on table 

TERMINAL LIST TABLES (TLT) 

The Terminal List Tables provide the user of CICS with the means of 
retaining the terminal identifications in logical groupings. A logical 
grouping of terminals could be all the terminals that are under the 
control of a supervisor. Each supervisor might have a Terminal List 
Table. All terminals which serve a similar function represent a logical 
grouping, or class of terminals. The user might create a grouping of 
terminal identifications to facilitate the dispatching of general 
messages to terminals. 

The system service programs of CICS use Terminal List Tables to 
perform terminal status change operations. A unique Terminal List 
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Table must be created for each supervisor who is to have the ability 
to alter the terminal status of any terminal under his control. Any 
operation which is to change the status of an entire group of terminals 
requires a Terminal List Table containing the identifications of all 
terminals in that group. Unique identification is assigned to each 
table by the user. 

The creation of the Terminal List Tables is accomplished through 
the assembly procedure by using the DFHTLT macro instruction. The 
following operands can be included in this macro instruction: 

DFHTLT TYPE=INITIAL, * 

SUFFIX=XX 

DFHTLT TYPE=ENTRY, * 

TRMIDNT=terminal identification 

DFHTLT TYPE=FINAL 

The Terminal List Table must be assembled and link edited with a 
name that conforms to the format: DFHTLTxx. The base name is DFHTLT. 
The two-character suffix (xx) , uniquely identifying this table, consists 
of the same characters entered by a user of the" system service programs 
for terminal status change. These two characters are appended to the 
base name (DFHTLT) for the retrieval process, and may represent either 
a supervisor's identification or the identification of a class of 
terminals. 

There must be an entry in the Processing Program Table (PPT) for 
each Terminal List Table the user wishes to access. 

Establish Termi nal List Ta.ble Control Section 

The control section into which the Terminal List Table is assembled 
is established by the 

DFHTLT TYPE=INITIAL, * 

SUFFIX=xx 

macro instruction, which must be coded as the first statement in the 
source deck used to assemble the Terminal List Table. 

SUFFIX: This operand is used to specify a two-character suffix for 
the Terminal List Table being assembled. This suffix, if specified, 
is appended to the standard module name (DFHTLT) and is used to name 
the module on the linkage editor output library. If this operand is 
omitted, a suffix is not provided. 

Specify T ermina l Identification 

The terminal identifications to be included in the Terminal List 
Table are specified through the 

DFHTLT TYPE=ENTRY, * 

TRMIDNT=terminal identification list 

macro instruction. Any number of these macro instructions can appear 
in a Terminal List Table assembly. 

TRMIDNT: Specifies a list of terminal identifications to be included 
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in the table. Any symbolic identification used must first have been 
defined in the TRMIDNT operand of the DFHTCT macro instruction. 

Specify. End of Terminal List Table 

The end of the Terminal List Table is indicated by the 

DFHTLT TYPE=FINAL 

macro instruction, which is the last statement in the assembly of the 
Terminal List Table before the Assembler END statement. The Assembler 
END statement must include the label DFHTLTBA. 

Terminal List Table Example 

Figure 10 illustrates the coding required to create a Terminal List 
Table. 



DFHTLT TYPE=INITIAL, * 

SUFFIX=AA 
DFHTLT TYPE=ENTRY, * 

TRMIDNT=(NYC,CHI,LA,WDC) 
DFHTLT TYPE=ENTRY, * 

TRMIDNT=(SF,ATL) 
DFHTLT TYPE=FINAL 
END DFHTLTBA 



Figure 10. Coding for terminal list table 
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SYSTEM PROGRAMMING CONSIDERATIONS 



CREATING USER EXITS FOR CICS MANAGEMENT PROGRAMS 

CICS provides a technique for incorporating user-written source code 
into most of the CICS management programs. This source code may extend 
various CICS management functions. So long as the user conforms to 
certain restrictions and conventions, this facility should minimize 
the impact of CICS source code modifications when installing new 
releases of CICS. 

To include a user-written exit routine in a particular CICS 
management program, the user must place his source code in a CICS source 
library member (book) which has the naming convention: 

DFHxxEXT 

where xx is the two-character designation for the management program 
into which the user-written code is to be included. The two-character 
designations are: 

KC (Task Control) 

SC (Storage Control) 

PC (Program Control) 

TC (Terminal Control) 

FC (File Control) 

IC (Interval Control) 

TD (Transient Data Control) 

TS (Temporary Storage Control) 

The code provided by the user in a given member (book) may consist 
of more than one routine (function) depending upon the number of 
linkages provided in the particular CICS management program. For 
example. File Management provides linkage to user-written exit routines 
both before and after an input operation. Thus, user-supplied code in 
the member (book) DFHPCEXT might contain two routines, each identified 
by a unique symbolic name. 

Linkage from the CICS management program to the appropriate 
user-written exit routine is accomplished by one of the following 
methods: 

1. An Assembler BAL instruction that uses the user-defined symbolic 
name as the "branch to" label and general register 14 as a return 
register. 

2. Register 14 is loaded with an address constant for the user 
defined symbolic name and a BALR 14, 14 instruction is issued. 

Note.: The user-written exit routines are located at the end of the 

management programs. The length of some programs is such that 
the exit routines are not addressable by the program's base 
register (s) . This situation forces the use of method two above, 
and requires the exit routine to establish its own addressability 
upon gaining control. 

Under method one at least some beginning part of the user exit 
routine is addressable by a management program base register. 
Another base register may be required for the rest of the exit 
routine. 
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The symbolic name of the exit routine is specified in the appropriate 
operand when the management program is generated. For example, in 
response to the 

DFHSG PROGRAM=SCP, * 

XTYPBEQ=ORANGE 

specification, user exit linkage in the form of an Assembler 

BAL 14, ORANGE 

instruction is generated in the appropriate place in the Storage Control 
program. In this example, source code similar to the following should 
have been provided by the user in the member (book) DFHSCEXT: 

ORANGE DS OH USER EXIT ENTRY 



User code 



3R 14 

Upon entry to a user exit routine, registers can be saved in the 
CSA register save area (CSAOSRSA). The following example shows the 
use of OS/DOS SAVE and RETURN macro instructions to save registers 4 
through 6 and to use register 4 as a base register. 

ORANGE DS OH USER EXIT ENTRY 

SAVE (4,6) SAVE REGS 4,5,6 

IN CSAOSRSA 
BALR 4,0 USE REG 4 AS BASE REG 

USING *,4 



RETURN (4,6) RESTORE REGS 4,5,6 

AND RETURN VIA REG 14 

Using the CSA for register saving is a non-reentrant method and 
therefore the exit routine should not issue any CICS or OS/DOS macro 
instructions that might reguire use of this CSA area. This includes 
releasing control to another task which might use this same (or another) 
exit routine that saves registers in the CSA. 

When creating the CICS management program assembly jobs during system 
generation, a COPY DFHxxEXT statement is included immediately preceding 
the Assembler END statement. In the above example, the following would 
be generated: 

COPY DFHCSADS 
COPY DFHTCADS 



COPY DFHSCP 
COPY DFHSCEXT 
END DFHSCNA 

When coding user exits for CICS management programs, the user should 
adhere to the following conventions and guidelines: 
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1. Since user exits are essentially "in line" with the management 
programs, the coder should be familiar with the functions of 
the program to which the exit code is being added. 

2. User-written exit routines must never alter the contents of 
registers that provide addressability to control blocks, unless 
the original contents are restored before return to the CICS 
management program. 

3. User-written exit routines must never violate restrictions of 
the management programs. For example, an exit routine in Storage 
Control cannot issue a DFHSC TYPE=GETMAIN macro instruction. 

In general, it is best if exit routines do not issues requests 
for CICS services. 

4. User-written exit routines must be coded in Assembler language. 

5. Symbolic names (labels) used to define user exit entry points 
must not be duplicates of labels in the CICS management program. 

6. Base register addressability for the user-written exit routine 
exists only to the extent of the base register (s) associated 
with the management program. The user exit must never alter 
the base register (s) of the management program. The user is 
responsible for saving registers and establishing addressability. 

7. Register contents differ depending on the management program 
and particular exit function. However, the contents of the 
following registers are always constant: 

REGISTER CONTENTS 

14 Return address 

13 CSA address 

12 TCA address 

Depending on the management program and functional user exit, certain 
general registers contain information that the user may find useful. 
The following is a summary, by exit, of the contents of these registers: 
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SYSGEN 








EXIT 






PROGRAM 


IDENT 


LINKAGE LOCATION 


registe: 


DFHKCP 


XDSPCHR 


Before dispatch 


TCACBAR 




XTYPREQ 


Before request 
analysis 


TXACBAR 


DFHPCP 


XFETCH 


After load 


PPTCBAR 

pcecreg 



DFHICP XICEEXP 

XTYPREQ 

DFHSCP XTYPREQ 

DFHTCP XATTACH 

XOUTPUT 

XINPOT 

DFHFCP XOUTPUT 

XINPUT 
XINPUTC 

XTYPREQ 

DFHTDP XOUTPUT 
XINPUT 
XYTPREQ 

DFHTSP XOUTPUT 
XINPUT 
XTYPREQ 



After expiration ICECBAR 
of time interval 

Before request N.A. 
analysis 

Before request N.A. 
analysis 

Before task attach TCTTEAR 

TCTLEAR 
TIOABAR 

Before output event TCTTEAR 

TCTLEAR 
TIOABAR 

After input event TCTTEAR 

TCTLEAR 
TIOABAR 



Before output event 

Before input event 
After input event 

Before entry 
Analysis 

Before output event 

Before input event 

Before request 
analysis 



FWACBAR 
FCTDSBAR 

FCTDSBAR 

FCTDSBAR 

FIOABAR 
N.A. 

DCTCBAR 
DCTCBAR 
DCTCBAR 



Before output event TSWKREG 

After input event TSWKREG 

Before request TSDA 
analysis 



REGISTER CONTENTS 

Address of TCA beinq 
dispatched 
Address of TXA 
associated with task 
(CICS/DOSE only) 

Address of PPT entry 
for loaded proqram 
Entry point address 
of loaded proqram 

Address of Interval 
Control Element (ICE) 
just expired 
N.A. 



N.A. 



Address 
Address 
Address 
Address 
Address 
Address 
Address 
Address 
Address 



of TCTTE 
of TCTLE 
of TIOA 
of TCTTE 
Of TCTLE 
Of TIOA 
Of TCTTE 
Of TCTLE 
of TIOA 



Address of 
Address of 
for tarqet 
Address of 
for target 
Address of 
for tarqet 
Address of 
N.A. 



FWA 

FCT entry 
data set 
FCT entry 
data set 
FCT entry 
data set 
FIOA 



Address of DCT entry 
for tarqet destination 
Address of DCT entry 
for tarqet destination 
Address of DCT entry 
for tarqet destination 

Address of data beinq 
read or written 
Address of data beinq 
read or written 
Address of data area 
specified by requestinq 
program 



N ot e: CICS provides a set of dummy exit members (books) as part of 
its distributed source library. These members contain only 
dummy labels and a BE 1t instruction, and should be replaced by 
user-written exit routines. 
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CREATING A TEFJSINAL ERROR PROGRA M (DFHTEP) 

The GIGS terminal error handling structure is based on the assumption 
that most users will want to expand and refine certain CICS operations 
in response to various terminal errors. Since it is impossible for 
CICS to anticipate all courses of action, the error handling facilities 
have been designed to allow the user maximum freedom in providing unique 
solutions for errors occurring within his terminal network. 

Three CICS components are involved in the detection and correction 
of terminal errors: 

1. Terminal Control program (DFHTCP) 

2. Terminal Abnormal Condition program (DFHTACP) 

3. Terminal Error program (DFHTEP) 

DFHTCP and DFHTACP are provided by CICS to perform certain basic 
detection and correction functions. DFHTEP is provided by the user 
who wishes to expand or alter the basic functions performed by DFHTCP 
and DFHTACP. A dummy DFHTEP is distributed with CICS containing only 
a DFHPC TYPE=RETURN macro instruction. 

TERMINAL ABNOPMAL CONDITION LINE ENTRY (TACLE) 

When an abnormal condition occurs that is associated with a terminal 
or line, DFHTCP places the terminal out of service and dynamically 
creates a Terminal Abnormal Condition Line Entry (TACLE) which is 
chained off the real line entry on which the error occurred. The TACLE 
contains all the error information necessary for proper evaluation of 
the error, plus special action indicators that can be manipulated to 
alter the error correction procedure. 

DFHTACP is then attached by the Terminal Control program and provided 
with a pointer to the real line entry (TCTLE) on which the error 
occurred. After performing certain basic error analysis and 
establishing default actions to be taken, DFHTACP gives control to 
DFHTEP by issuing a DFHPC TYPE=LINK macro instruction. DFHTACP passes 
the TACLE to DFHTEP so DFHTEP can examine the error and provide an 
alternate course of action. 

Once the user has performed his desired function in DFHTEP, he should 
return control to DFHTACP by issuing a DFHPC TYPE=RETURN macro 
instruction. DFHTACP then performs the necessary actions as dictated 
by the action flags within the TACLE. 

When DFHTEP receives control from DFHTACP, the TCA Facility Control 
Address (TCAFCAAA) contains the address of a TACLE. The TACLE is 
created by the Terminal Control program when the error occurs and 
contains all the I/O error information provided by BTAM. 

To symbolically access the information contained in the TACLE, CICS 
provides two symbolic storage definitions (DSEC^s) which can be copied 
into DFHTEP. These DSECT's are DFHTACLE and DFHTCTLE. DFHTACLE 
describes the first twelve bytes of the TACLE which contain CICS error 
information; DFHTCTLE describes the remainder of the TACLE which 
contains a copy of the Data Extent Control Block (DECB) at the time 
the error occurred, plus other valuable information. 

To establish addressability to the TACLE, DFHTEP must provide, upon 
entry, the instruction: 

L TCTLEAR, TCAFCAAA LOAD TACLE BASE REGISTER 
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where TCTLEAR is symbolically defined as the base register for the 
TACLE. If the user desires to access the real line entry in the TCT, 
its address is at location TCTLEDCB within the TACLE. It is the user's 
responsibility, under these circumstances, to maintain addressablity 
between the TACLE and the real line entry. 

DFHTEP PROGRAMMING CONSIDERATIONS 

The TACLE is the basic interface that should be used by user-written 
DFHTEP to determine the nature of the error that occurred and to 
indicate what course of action is to be taken. 

Before giving DFHTEP control, DFHTACP establishes certain default 
actions to be taken, depending upon the error condition. Within DFHTEP, 
the user may choose to accept the default action under certain 
circumstances and alter the action under other circumstances. To 
indicate that an alternate action is to be taken, the user must modify 
the action flags contained in the two-byte field of the TACLE labeled 
TCTLEECB+1 and TCTLEECB+2 (the second and third bytes in the DECB copy) . 

The default actions scheduled by DFHTACP before entry to DFHTEP are 
described in the following; the error code is found in the TACLE at 
TCTLEPFL. 



1 = Line out of service 

2 = Terminal out of service 

3 = Abend transaction 

4 = Switched line disconnected 

5 = Disconnect switched line 

6 = Release TCAM TIOA 



(X' 


80' 


(X> 


08« 


(X 


04' 


(X 


20' 


(x- 


10' 


(X 


80' 



at TCTLEECB+1) 
at TCTLEECB+1) 
at TCTLEECB+1) 
at TCTLEECB+1) 
at TCTLEECB+1) 
at TCTLEECB+2) 



ERROR CODE 
(SYMBOLIC LABEL) 

X'81« (TCEMCMTL) 
X'82» (TCEMCTRL) 



C ONDITI ON 

Input msg exceeds read length 
Translation error 
(TCT does not correspond to TCP) 



ACTION SET 
BY DFHTACP 

3 
2 



X'84' (TCEMCTCT) 



TCT search error 

a. Switched line 

b. Non-switched line 



X'85' (TCEMCROT) 



Invalid write reguest 

a. A write reguest was made to a 
terminal in INPUT status. 

b. A write reguest was made to a 
3735 before 'EOT' (EOF condition) 
was received from the 37 35 during 
batch transmission. 



'X'86« (TCEMCPL) 
X'87' (TCEMCUI) 



Polling list error 
Unsolicited input 

a. TCAM 

Terminal "Receive Only"; 
Terminal "Out of Service"; 
Task has not issued READ 
(no default actions) . 

b. Input has occurred on an out- 
of-service terminal. (3735) 



6 
2,6 



X'88« (TCEMCIER) 



BTAM return code on read 

a. Local 3270 open failure, 
Invalid RLN, unreliable 



2,3 
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ERROR CODE 
(SYMBOLIC LABEL) 



X'89' (TCEMCSM) 



X^A* (TCEMCTO) 
X«8B' (TCEMCOBE) 

X'8C» (TCEMCOER) 



X'8D' (TCEMCOLZ) 
X'8E» (TCEMCNOA) 
X»8F« (TCEMCOAE) 



X«94» (TCEMCUC) 
X'95* (TCEMCDCS) 



X«96' 
X»97« 



(TCEMCUE) 
(TCEMCDES) 



X'98» (TCEMCNR) 
X»99» (TCEMCUDT) 
X^B 1 (TCEMCICR) 



COND ITION 

information (DOS) , device 

under OPTEP 

All other conditions 



ACTION SET 
BY DFHTACP 



1,3 



Error status received from remote 3270 , s. 

a. 3270 operation check 3 

b. 3270 intervention required 

c. 3270 all other conditions 2,3 

d. 3735 all conditions 



7770 32-second timeout 

Hardware buffer exceeded (shift 
character not properly accounted for) 

BTAM return code on write 

a. Local 3270 open failure. 
Invalid RLN r unreliable 
information (DOS) , device 
under OLTEP 

b. All other conditions 

Output length zero 
No output area provided 
Output area exceeded (TIOATDL 
value larger than output area) 

Unit check (actions same as TCEMCUCS) 
Unit check (should not occur) 

a. Not BTAM line or L3270 

b. Switched line disabled (CICS/OS) 
in combination with following: 

Intervention sense 

c. Switched line 

d. Non-switched line 

e. Dummy terminal 

Data check sense 

f. Real terminal 

g. Dummy terminal 

Timeout sense 
h. READ text command 
i. Real terminal 
j. Dummy terminal 

All other sense 



3 r 5 
3 

2,3 

1,3 

3 
3 

3 



3,4 

2,3 

1 



2,3 
1 



2 r 3 
1 

1 



Unit exception (actions same as TCEMCUES) 
Unit exception (should not occur) 

a. Switched line 3,4 

b. Real terminal 2,3 

c. Dummy terminal 1 



Negative response to addressing 
Undetermined unit error 
The terminal entries on the 'to' 
and 'from 1 device did not specify 
the COPY feature (3270) . 

The device address specified for 



2,3 

1,3 

3 
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ERROR CODE 
(SYMBOLIC LABEL) 



ACTION SET 
BY DFHTACP 



X»9C» (TCEMCIMB) 



X«9D» (TCEMCICM) 



X«9F» (TCEMIDR) 



X f A0» (TCEMCWOT) 



X«A1" (TCEMCIDR) 



CONDITION 

the •to 1 device does not exist 
on the control unit. 

The length of the COPY command 
was not specified as one. 



Invalid message block received. 

a. An unidentified message block 2,3 
was received from a local or 

remote 3270. 

b. The type of input block received 2,3 
from a 3735 did not agree with 

the mode of the active transac- 
tion inquiry/batch. 

An incomplete message was received 2,3 
from a remote 3270. The device 
terminated transmission prior to 
message completion (that is, EOT 
received prior to ETX) . 

TCAM has issued an invalid destin- 3 
ation return code to CICS. 

Invalid Read request: 

a. A Read request was issued to a 3 
terminal in RECEIVE status. 

b. A Read was issued to a 3735 3 
terminal after EOT (EOF condition) 

was received from the terminal 
during batch transmission. 



A transaction has requested a DFHTC 
TYPE= (RESET, DISCONNECT) on a switched 
binary synchronous line and no EOT has 
been received from the terminal; 
this indicates more data is to 
follow. Terminal Control issues 
a read to the terminal if an EOT has 
been received. If the EOT is not 
received on that read, the error 
code is set and passed to DFHTACP. 

Following is a diagram of the Terminal Abnormal Condition Line Entry 
(TACLE) which is pointed to by the TCAFCAAA field upon entry to DFHTEP: 
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Dec. 




16 



14 



18 



28 



44 



TERMINAL ABNORMAL CONDITION LINE ENTRY 



Hex.* < 4 BYTES >* 

* . * 

* TCTLEPSA * 

* * 

* STORAGE ACCOUNTING AREA * 



10 



12 



1C 



2C 



TCTLEPCH 



ADDRESS OF TACLE WORK AREA 



* TCTLEPFL * TCTLEPF2 * TCTLEPTE 

* * * 

* ERROR FLAGS * SPECIAL IND * TCTTE DISPLACEMENT 

* , 



* TCTLEECB * 

* BEGINNING * ACTION 

* OF DECB * FLAGS 



* * 

* RESERVED * 
*FOR DFHTACP* 



* 
* 
* 

* 

* 
* 
* 

* 
* 
* 

* 

* 
* 
* 
* 

* TCTLGALP * 

* BSAM * 
*.. SENSE * 



NOT USED 



TCTLEDCB 



ACTUAL LINE ENTRY ADDRESS 



NOT USED 



NOT USED 



TCTLECSW 



BSAM STATUS 



NOT USED 



BTAM * 

RETURN * 

CODE * 



shsjc^A A A A^^^ A A^ A^^ A^^t^i&^icic^^^^^^^^^ A A^ AA AAAAAAA sfic 30c sflc sGc sfic 3Bc sfie sic 



Displacement 








Dec.. 


Hex.. 


Code 


Bytes 


Label 










4 


TCTLEPSA 


4 


4 




4 


TCTLEPCH 



81 
82 
84 
85 



TCTLEPFL 



M ean ing 



Storage accounting 
Pointer to 100 bytes of user 
storage that can be used to 
write to Transient Data. 
This storage must not be 
freed by DFHTEP, as DFHTACP 
may reuse it. 

Error flags 
Input error 
Translation error 
TCT search error 
Invalid write 
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PJrgPJr^cement 

2©£j. Hex . Code Bytes Label Meaning 

86 Polling list error 

87 Unsolicited input 

88 Input event rejected 

89 Status message received 
8A 7770 32-second timeout 
8B Hardware buffer exceeded 
8C Output event rejected 

8D Output length of zero 

8E No output area 

8F Output area exceeded 

94 Unit check 

95 Unit check (should not occur) 

96 Unit exception 

97 Unit exception (should not 

occur) 

98 Negative response 

99 Undetermined I/O error 
9B Copy error (3270) 

9C Invalid message block 

9D Incomplete message 

9F Invalid TCAM destination 

A0 Invalid read 

A1 Invalid disconnect 

• 

(All codes not listed are reserved) 

Special indicator 

01 Dummy terminal 



1 


TCTLEPF2 


2 


TCTLEPTE 


48 


TCTLEECB 



10 A 2 TCTLEPTE Displacement from line 

entry to terminal in error 

12 C 48 TCTLEECB DECB/copy of line when 

error occurred 

Following is the definition of the action bits (0,3,4,5,6 and 7) 
and information bits (1 and 2) and is the only portion of the copy of 
the DECB that can be altered. They are located at label TCTLEECB+1. 

In the second interface byte (TCTLEECB+2) , bit is used to process 
TCAM unsolicited errors. Upon entry to TEP if this bit is set for 
unsolicited input, it indicates that the data is destined for a terminal 
entry that is either Out of Service or in Receive Only status. If not 
set in this manner, the terminal entry for which the data is destined 
has a task which has not issued a BEAD request. Upon entry to TEP, 
this data is on the Input Queue Terminal Entry storage chain, and is 
located by label TCTLEIOA in the TACLE. Upon return to TACP from TEP, 
this bit (if set) is used to free unsolicited data or to allow another 
time delay cycle if not set. 

P®£Lt Hex . Bytes Label Meaning 

13 D 1 TCTLEECB* 1 Interface byte 

Bit Place line in service 

1 Place line out of service 

Bit 1 Information Bit 

. Not used 

.1.. .... Non purgeable task exists 
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Dec, 



Hex, 



Bit 2 

Bit 3 
Bit 4 
Bit 5 
Bit 6 



Bit 7 



Bytes Label 



. .0. 
. .1. 



0. 
1. 

.0 

.1 

..0 



..1 



Meaning 

on terminal 

Information Bit 

Not used 

Switched line has been 

disconnected by BTAM 

Do not disconnect line 

Disconnect line 

Place terminal in service 

Place terminal out of service 

Do not abend task 

Abend task 

Leave terminal's associated 

control unit on poll list 

Take terminal's associated 
control unit off poll list 

Do not abort WRITE or 
free terminal storage 
on task abend or no task 
present on terminal 

Abort terminal WRITE 
requests and free terminal 
storage on task abend or 
no task present on terminal 



14 



15 


F 


20 


14 


42 


2A 


44 


2C 



Bit 



Bit 1-7 



TCTLEECB+2 


Interface byte 2 


1 • ■ • •••• 


Do not release TCAM TIOA 
Release TCAM unsolicited 
input TIOA 


TCTLEECB+3 
TCTLEDCB 
TCTLECSW 
TCTLEALP 


Reserved 

BTAM return code 

Actual line entry address 

BSAM Status 

BSAM Sense 



The following factors should be considered when altering the action 
bits in the TACLE: 

1. If the "task abend" flag is set by DFHTACP (X'04« at TCTLEECB+1) , 
the "non-purgeable" flag (X'40 1 ) is also set if the task is 
non-purgeable. 

2. If the "task abend" bit is on upon return to DFHTACP from DFHTEP 
and a non-purgeable task exists on the terminal, the terminal 

is placed out of service and the task remains attached to the 
terminal. 

3. If a dummy terminal is indicated (X'01 1 ) at TCTLEPF2, a 
disconnect request from DFHTEP is not honored by DFHTACP. (A 
dummy terminal is created whenever an error occurs on a terminal 
whose address does not exist in the TCT.) 

4. The "switched line disconnected" bit is used by DFHTACP upon 
return from DFHTEP to logically disconnect the switched line 
that has been physically disconnected. If DFHTEP determines 
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that the line has not been physically disconnected, DFHTEP may 
reset this bit. 

5. If the "switched line disconnected" bit or the "disconnect 
switched line" bit is on, upon return from DFHTEP, the "task 
abend" bit should also be set to purge the task from the 
disconnected terminal. If this is the case and if the task is 
not terminal purgeable, DFHTACP writes an INTERCEPT REQUIRED 
message to destination CSMT and places the terminal out of 
service. 

6. The dummy terminal indicator at TCTLEPF2 is set on errors such 
as: (1) BTAM return on input, (2) binary synchronous outputs 
performed for TCP where no terminal is indicated, and (3) other 
errors where no terminal error conditions are indicated. 
Therefore, if Dummy Terminal is indicated, task abend and write 
abort are not set. The Dummy Terminal is only used to identify 
the line. 

7. The write abort bit (bit 7 at TCTLEECB+2) is always set with 
task abend request in TACP as a default. Upon return from TACP, 
the write abort bit is used as follows: 

a. Causes the Terminal Control write requests to be aborted. 

b. If the task is being abended and is terminal purgeable 
or task exists on the terminal, the Terminal Storage 
will be freed. 

The following is an example of the logic steps necessary to design 
a portion of the Terminal Error program. In this example ten retries 
are provided per terminal; however, the logic could be used for any 
number of retries. The following assumptions are made: 

USER FIELD A Represents a six-byte field in the Process Control 

(PCISAVE) Information (PCI) area of the TCTTE (see the TCT macro 
definition of the TCTUAL operand) . This field is used 
to preserve the count of input and output from the TCTTE 
when the first error occurs. These counts are contained 
in three-byte fields located at TCTTENI and TCTTENO 
within the TCTTE. 

USER FIELD B Represents a user-defined field used to 

(PCICNT) accumulate the count of recursive errors. It would most 
likely be in the Process Control Information (PCI) area 
of the TCTTE. 

SYSTEM COUNT Represents the six-byte field in the TCTTE that contains 
(TCTTENI) the terminal input and output counts (TCTTENI+TCTTENO) . 
In the example, these two adjacent fields are considered 
as one six-byte field. 

Since this example requires access to the TCT terminal entry (TCTTE) 
to examine the SYSTEM COUNT and to also locate the Process Control 
Information (PCI) area, the DFHTCTTE symbolic storage definition is 
included so fields may be symbolically referenced. 

*********** ************************************************ ************* 

* * 

* DFHTEP RECURSIVE RETRY ROUTINE * 

* * 
************************************************************************ 
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TEPBAR 

TCTTEAR 

PCIBAR 



PCIAREA 
PCISAVE 
PCICNT 

DFHTEP 



EQO 2 

EQU 9 

EQU 8 

COPY DFHTCTTE 

EJECT 

COPY DFHTACLE 

COPY DFHTCTLE 

EJECT 

DSECT 

DS 6X 

DS PL2 

EJECT 

CSECT 

BALR TEPBAR, 

USING *, TEPBAR 

L TCTLEAR,TCAFCAAA 

L TCTTEAR,TCTLEDCB 



AH 



TCTTEAR, TCTLEPTE 



* 
* 

* 

RESET 
* 

* 

INCR 
* 



L PCIBAR, TCTTECIA 
USING PCIAREA, PCIBAR 
TM PCICNT + I^OC 



BO 



CKCOUNT 



MVC PCICNT, =PL2»+0» 
MVC PCISAVE (6) ,TCTTENI 



AP 



PCICNT, =P»1» 





CP 


PCICNT, =P» 10» 


* 








BNE 


RETRY 


* 








ZAP 


PCICNT, =P'0« 




MVC 


PCISAVE (6) ,TCTTENI 




B 


NORETRY 


CKCOUNT 


CLC 


PCISAVE (6) ,TCTTENI 


* 








BNE 


RESET 


* 






* 






* 








B 


INCR 


* 






* 






* 






RETRY 


DS 


OH 



NORETRY DS 



OH 



TEP PROGRAM BASE 

BASE REGISTER FOR TCTTE 

BASE FOR PCI 

COPY TCTTE DEFINITION 

COPY TACLE SYMBOLIC DEFINITIONS 
COPY DECB DEFINITION 



USER FIELD A 
USER FIELD B 



ESTABLISH PROGRAM ADDRESSABILITY 

LOAD TACLE ADDRESS 
LOAD TCTTE BASE WITH 
REAL LINE ADDRESS 
INCREMENT BASE BY THE 
TCTTE DISPLACEMENT. THIS 
GIVES ADDRESSABILITY TO TCTTE. 
LOAD PCI AREA ADDRESS 
ESTABLISH ADDRESSABILITY 
HAS USER FIELD B EVER BEEN 
INITIALIZED TO A PACKED 
DECIMAL NUMBER? 
.. YES, SO COMPARE THE 
SYSTEM COUNT WITH THE 
EXISTING COUNT IN FIELD B; 
.. NO, SO INITIALIZE FIELD 
B TO A PACKED DECIMAL 0. 
SAVE THE CURRENT SYSTEM 
COUNTS. THIS IS A NEW 
ERROR, OR FIRST TIME THROUGH 
INCREMENT THE NUMBER OF 
TIMES THIS SAME ERROR ' HAS 
OCCURRED. (RECURSIVE COUNT) 
HAS THE MAXIMUM RECURSIVE 
ERROR LIMIT BEEN REACHED? 
.. NO, SET ACTION 
INDICATORS FOR RETRY ATTEMPT 

* CLEAR AND RESET USER FIELDS 

* FOR NEXT ERROR SET 

ACTION INDICATORS FOR NO-RETRY. 

HAS SYSTEM COUNT CHANGED SINCE 

LAST ENTRY TO TEP? 

.. YES; THAT MEANS THIS IS 

A NEW ERROR SINCE SOME I/O 

ACTIVITY HAS OCCURRED ON 

TERMINAL 

.. NO; THAT MEANS THIS IS A 

RECURSIVE ERROR, SO 

INCREMENT THE RECURSIVE COUNT 

AND CHECK FOR RETRY. 

THE USER WOULD INCLUDE HERE 

THE CODE NECESSARY TO ALTER 

THE FLAGS IN THE TACLE SO 

THAT A RETRY CAN BE PERFORMED 

ON THE TERMINAL. 

THE USER WOULD INCLUDE HERE 

THE CODE NECESSARY TO ALLOW 

DFHTACP TO TAKE FINAL ACTION 

ON THE TERMINAL (I.E., ABEND TASK, 

PUT LINE OUT OF SERVICE, ETC.) 
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The above example is intended only to serve as an illustration of 
a recursive error handling technique and the steps necessary to 
establish addressability to the applicable control blocks. 

DFHTEP ALTERNATE INTERFACE (CICS/OS only) 

An alternate interface is provided in the CICS/OS-STANDARD system 
for the purpose of maintaining compatibility with the CICS/OS-STANDARD 
Version 1 user who currently has code dependent upon this interface. 
This interface is provided when the user specifies V1CMPAT=YES in the 
DFHSG TYPE=CSO macro instruction during system generation. 

Upon detection of an error, control is passed to DFHTEP for analysis; 
the TWA contains the following information: 

BYTES I: ABEL DEFINITION 

1 TWACOBA Contains the status byte from BTAM 

1 TWACOBA+1 Contains the sense byte from BTAM 

1 TWACOBA+2 Contains the teleprocessing OP code 

being issued 

1 TWACOBA+3 Reserved 

4 TWACOBA+4 Contains the transaction ID if one exists 

for the terminal in error 

User-written DFHTEP must place the line or terminal in service or 
out of service if so desired. If the task is to be abended, DFHTEP 
must place a X'FE 1 at label TWACOBA before returning control to DFHTACP. 

7770 32-SECOND TIMEOUT CONSIDERATIONS 

If a terminal connected to the 7770 Audio Response Unit goes "on 
hook" while no I/O operation is outstanding, the 7770 does not present 
the unit exception to the channel. This situation can occur when the 
terminal operator makes an inquiry and hangs up before receiving a 
response. After this occurs, all writes to the line appear to complete 
normally. All reads complete normally at the end of the 32-second 
timeout with a zero data length. 

When a 32-second timeout occurs, either the terminal operator has 
not entered anything for 32 seconds, or the terminal operator has hung 
up and the 7770 did not inform CICS. CICS cannot distinguish between 
these two conditions; therefore, CICS handles every 32-second timeout 
as an error condition. DFHTACP goes to DFHTEP with defaults of 
DISCONNECT SWITCHED LINE and ABEND THE TRANSACTION. If DFHTEP does 
not disconnect the switched line, CICS writes the "ready" message and 
initiates another read. 

WRITING A TRANSACTION TO IPL THE SYSTEM/7 

To initial program load (IPL) the System/7 from CICS, the user must 
write a transaction that issues an automatic transaction initiation 
request to either Interval Control or Transient Data Control. This 
transaction is usually initiated from the master terminal or from a 
sequential terminal. The initiated transaction is started on the 
System/7; it then writes the IPL records to the System/7. 
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The IPL records are prepared by the user and consist of: 

1. UZERO, a utility module 

2. UTIPL, a utility module 

3. System/7 storage load 

UZERO and UTIPL are provided in object deck form on the MSP/7 
distribution tape under member names CAAUZERO and CAAUTIPL, 
respectively. If link edited into the user-written application program, 
UZERO and UTIPL are available for transmission in a suitably translated 
format. 

The first two bytes of each of these modules is a count of the number 
of characters in the remainder of the module. These two bytes must be 
placed in the user's TIOA at TIOATDL by the application program. The 
remainder of the module is moved to TIOADBA. UZERO and UTIPL may then 
be transmitted to the System/7 by issuing the DFHTC TYPE- (WRITE, WAIT) 
macro instruction in the application program. 

The System/7 storage load is generated using the TELETRANS option 
of the MSP/7 Output Handler. The storage load is comprised of 
80-character records that may be read via the Transient Data or File 
Control facilities of CICS and transmitted to the System/7 by issuing 
a series of DFHTC TYPE= (WRITE, WAIT) macro instructions. If a DFHPC 
Type=Return macro instruction is used to allow the System/7 to begin 
execution, the user must ensure that no automatically initiated 
transaction is scheduled to begin on the System/7 until at least 10 
seconds have elapsed following execution of the DFHPC Type=Return macro 
instruction. 

For more information concerning the preparation of IPL records for 
the System/7, see the publication Modula r System Pro grams (MSP/7) 
P rogramm ing Gui de (GC34-0013) . 

2260 COMPATIBILITY FOR THE 3270 

2260-compatibility support for the 3270 Information Display System 
allows the user to run his currently operational 2260-based transactions 
from a 3270. 

During CICS system generation, the user must request 2260 
compatibility to be included, thereby generating the necessary code to 
provide conversion of 2260 data streams from user-written application 
programs to the appropriate 3270 data stream format. When the 3270 
operates with a "compatibility" transaction, incoming data from the 
3270 is converted and presented to the user-written application program 
in 2260 format. In most cases, no changes are required to the 
user-written program. 

Because 2260 compatibility is specified by transaction as well as 
by terminal, non-2260-based transactions have full access to all 
facilities of the 3270. Only when a 2260-compatible transaction is 
attached to a 2260-compatible 3270 does CICS perform the editing of 
the input and output data streams. If the transaction is not specified 
as 2260 compatible, or if the terminal is not specified as supporting 
2260 compatibility, no editing occurs for the data streams. In that 
case, if the data streams are not valid 3270 data streams, the results 
are unpredictable. 

Two modes of compatibility operation are provided: FORMAT and 
FULLBUF. 
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FORMAT mode takes full advantage of the 3270 formatting and data 
compression facilities, and is the preferred method of 2260 
compatibility, particularly for the operation of remote 3270 , s. 
However, some 2260 facilities cannot be supported under FORMAT mode. 
For information concerning which facilities are available, see the 
discussion under the topic "Screen Techniques". 

FULLBUF mode does not use the 3270 data compression facilities and 
must therefore be used when all lines of input data are desired. For 
each operator interaction involving a data entry key (ENTER, PF1 - 
PF12), the number of characters transferred is approximately equal to 
the total number of characters on the simulated 2260 screen. The exact 
number of characters transferred varies depending upon whether the 3270 
is local or remote and which model of the 2260 is being mapped onto 
which model of the 3 270. 

Note: A terminal is considered to be in compatibility mode from the 
time a 2260-compatible transaction is initiated until (1) the 
CLEAR key is depressed, or (2) a 3270 native mode transaction 
is initiated. 

For local 327 operation, the extra data transfer of FULLBUF mode 
should be transparent to the user with regard to response time. For 
remote 3270 operation, the response time is a complex function of the 
present method of 2260 operation and the line speeds used for the 2260 
and 3270; however, the increase in the response time (on a transaction 
basis) should be less than 20% at the same line speed. 

CICS TABLE PREPARATION FOR 2260 COMPATIBILITY 

Individual transactions can be flagged for FORMAT or FULLBUF 2260 
compatibility through the DFHPCT TYPE=ENTRY macro instruction. The 
mode of compatibility chosen depends on the 2260 functions required 
for the application programs that run under this particular transaction 
code. 

The characteristics of the 2260/2265 terminal (which the 3277/3275 
replaces) are specified by additional operands for the DFHTCT 
TYPE=TERMINAL macro instruction. They are as follows: 

COMPAT=NO, (number of characters, number of lines, * 

device type, model number), * 

FEATURE= (PTRADAPT,SELCTPEN r AUDALARM,COPY,BUFEXP, * 
DCKYBD,UCTRAN) 

The "number of characters" parameter is used to specify the screen 
size of the 2260/2265 terminal. Applicable parameter values are 240, 
480, and 960. 

The "number of lines" parameter is used to indicate the number of 
lines applicable to the 2260/226 5 terminal or to insert new line (NL) 
symbols into the 3284/3286 printer output data stream where NL symbols 
are not provided by the user in the output data stream. Applicable 
parameter values are 6, 12, and 15. The default value for a 
960-character screen is 12. 

The "device type" parameter is used to specify a 2260 or 2265 
terminal or a 1053 printer. The default is 2260. Note that the 
specification COMPAT= (960, 15) results in an error condition since the 
2260 (assumed by default) cannot support 15 lines. 

The "model number" parameter is used to specify a model number for 
the 2260 terminal being simulated. This parameter provides an interface 
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for any user-written application programs that currently test the 
TCTTETM field before building device-dependent 2260 data streams. 

The FEATURE operand has been included in the CICS DFHTCT 
TYPE=TERMINAL macro instruction to indicate the presence of 3270 
Information Display System features (for example. Printer Adapter, 
Selector Pen, Audible Alarm, Copy feature. Buffer Expansion, uppercase 
translation, dual case keyboard) and to specify the corresponding 3284 
Model 3 Printer on the 3275 Display Station. 

No£e_i. A separate DFHTCT TYPE=TERMINAL macro instruction cannot be 
coded for the 3284 Model 3 Printer because the 3284 Model 3 
shares the buffer of the 3275 Display Station. 

2260 MODEL-DEPENDENT DATA STREAM 

Some users require the capability of building 2260 device-dependent 
data streams. CICS allows the user to build such data streams by 
providing the terminal type at TCTTETT in the Terminal Control Table 
(TCT) and the terminal model number at TCTTETM in the TCT. 

The TCTTETT and TCTTETM fields always contain the 2260 or 2265 
terminal type codes and user-assigned model number (as specified in 
the DFHTCT TYPE=TERMINAL macro instruction) whenever a transaction 
flagged for CICS 2260 compatibility is dispatched. At all other times, 
TCTTETT and TCTTETM contain the codes for the 3270 terminal. 



SCREEN TECHNIQUES 

Various techniques have been used for entering data using a 2260 
screen and keyboard. The following are examples of four basic 
techniques that may be used. 

1. Formatted 2260 screen technique; for example: 



► USER KEYED DATA 


X 


X A ^ 




A 


" A 


A" A ^ 




X X A 

X X- 





X- CONSTANT DATA X 
X X 



Hith this technique, the constant data is optional and is sent 
to the user at the start of the transaction. Either FORMAT or 
FULLBUF mode may be specified, depending upon the user's 
formatting reguirements. 
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2. 2260 tab feature technique; for example: 



► NAME: 
STREET: 
CITY: 



INITIAL: 

NUMBER: 

STATE: 



For CICS 2260 compatibility operation, the colon-tab character 
combination is replaced by 3270 "unprotected attribute" 
characters. FORMAT mode may be specified if data is always 
keyed into every field. FULLBUF mode must specified if any 
field is to be left blank. (Unlike the 2260, the 3270 does not 
transmit blank characters unless FULLBUF is specified.) If 
FULLBUF is not specified, any heading following the blank field 
is not transmitted to the application program. 



► NAME: JONES 
STREET: 
CITY: NEW YORK 



INITIAL: J* 
NUMBER: 1515 
STATE: 



FORMAT data stream: 
NAME:J0NES INITIAL:J(NL) 



:1515(NL) 



:NEW YORK 



FULLBUF data stream: 
NAME :J0NES INITIAL: J (NL) 



STREET: NUMBER: 151 5 (NL) CITY:NEW YOR. 



3. "Endless screen" technique; for example; 



X 


NEW DATA 




— 


X 


OLD DATA 



X ►NFW nATft 



With this technique, the 2260 screen is treated as unformatted. 
The operator keys off the screen, and, wrapping around to the 
start of the screen, overkeys any old data still there. The 
2260 transmits a data stream delimited by SMI (start of message) 
and EOM (end of message) characters, irrespective of any screen 
wraparound. 

Either FORMAT or FULLBUF can be specified. In either case, CICS 
ensures that the data stream is correctly ordered before sending 
it to the 2260-based transaction. 

With this technique, there is a difference in operation between 
FORMAT and FULLBUF modes only in the case of a 480-character 
2260 mapped onto a 480-character 3270. Use of FORMAT mode causes 
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4. 



the loss of the last character of every 2260 output line. Use 
of FULLBUF mode limits the data loss to the last character 
position of the last line but at the expense of transferring a 
full 480 characters (479 characters plus one attribute character) 
for each interaction involving a data entry key. 

It is the responsibility of the user to determine whether his 
2260 transaction can tolerate the loss of the last character of 
each output line. CICS appends a blank character to the end of 
each 2260 input line, except where the line is terminated 
prematurely by a new- line (NL) symbol. 

"Change and enter" technique; for example: 

►JONES J H 

1515 OLD ROAD EAST 
NEW YORK 



> 



ORIGINAL 
RECORD 



N.Y. 10010 _ 



► JONES 
1515 
NEW YORK 
N. Y. 10010 _ 



J H 

OLD ROAD WEST 



UPDATED 
RECORD 



The FORMAT data stream looks like this: 



JONES J H 1515 OLD ROAD WEST 

The FULLBUF data stream looks like this: 

J H 



JONES 
NEW YORK 



1515 OLD ROAD WEST 
N.Y. 10010 



The 2260 transaction sends an existing record to the screen. 
After making any necessary corrections to data fields, the 
operator depresses the ENTER key; the 2260 transaction receives 
the entire record in its updated version. 

With this technique, FULLBUF must be specified for this 
transaction to ensure that the transaction receives a 
2260-compatible data stream. 
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START OF MESSAGE INDICATOR (SHI) 

For the 2260, X'UA" is displayed as the SMI (►) character. If the 
SMI character is contained in an output data stream, it is displayed 
on the 3270 screen as follows: 

COUNTRY SMI SYMBOL 

U.S.A. J 

U.K. $ 

France $ or c 

Germany 6 

At the user's discretion, a different character may be specified 
during CICS system generation to represent the SMI. Whatever character 
is chosen, it remains the same for all transactions. 

If an SMI character is not placed on the screen by the user's 2260 
data stream, the operator must then key an SMI character somewhere on 
the screen. Failure to do so results in no data being transmitted to 
the application program. 

After the data has been read in, CICS 2260 compatibility transmits 
a single blank character to overwrite ;the SMI character. 

NEW LINE SYMBOL (NL) 

For CICS 2260 compatibility, the new line (NL) function is replaced 
by a field mark character followed by the NL key. Any incoming field 
mark characters are treated as 2260 NL characters, and the remainder 
of the line is discarded. 

Including the NL symbol in the 2260 output data stream causes the 
substitution of a 3270 field mark character; the output continues at 
the beginning of the next line. (The 3270 field mark character displays 
as a semicolon.) 

LINE ADDRESSING 

For a 3270 operating under CICS compatibility, any reguests for 
write at line address are honored. CICS 2260 compatibility converts 
the line address to the eguivalent 3270 buffer address before 
transmitting the data stream to the screen. 

2848 LOCK FEATURE 

The optional lock feature available on the 2848 Display Control 
Models 21 and 22 is supported by CICS 2260 compatibility. Any read/lock 
reguest is honored by CICS 2260 compatibility by leaving the 3270 
keyboard inhibited. The keyboard is reset only if the transaction 
changes or if a WRITE macro instruction is issued by the application 
program. 

2845/2848 TAB FEATURE 

The optional tab feature available on the 2845/2848 Display Control 
is supported by CICS 2260 compatibility. Any tab character (colon) 
found in the output data stream is replaced by an attribute byte. This 
attribute byte is converted back to a 2260 tab character on a read 
operation. 
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Because the tab feature uses an attribute byte, the terminal operator 
cannot key a tab character from the keyboard. The tab does not display 
on the screen, but is present in the user's input data stream. 

For proper operation, transactions using the tab technique are 
required to operate in FULLBUF mode. A tab character should not be 
inserted as the last character of a line. 

Because the tab feature uses an attribute byte, the cursor stops at 
the beginning of each line before stopping at the authorized attribute 
position, except in the case of 480/480 FULLBUF conversion. The cursor 
stops only at the authorized attribute position and the last position 
in the buffer. 



INITIATING TRANSACTIONS 

The terminal operator can initiate either 2260 compatibility or 3270 
native mode transactions by entering the appropriate four-character 
CICS transaction code. While in compatibility mode, any Start of 
Message Indicator (SMI) character in the input data stream is recognized 
by CICS; the succeeding four characters are interpreted as a CICS 
transaction code. The transaction code must be contiguous and may not 
span two fields. 

CICS then initiates the specified transaction. If the specified 
transaction is a 2260 compatibility transaction, CICS automatically 
formats the 3270 screen. 

To allow easy transition between 2260 compatibility and 3270 native 
mode transactions, some conventions should be followed. Three 
acceptable methods of transition between transactions are: 

1. Clear the screen; then enter the transaction code and any data 
to be presented to the transaction. 

In this case, the operator must enter the transaction code at 
the first position of the screen. The transaction code may be 
preceded by the SMI character, in which case the next four 
characters are interpreted as the transaction code. A 
transaction code may not contain an SMI character. 

2. For a terminal in compatibility mode, enter the SMI character, 
the transaction code, and data. If the transaction to be 
initiated is a compatibility transaction, all data from the SMI 
character to the cursor position is treated as a 2260 
compatibility data stream and is mapped into 2260 format. For 
a native mode transaction, the data stream is identical with 
the data stream from an unformatted screen buffer. 

3. For a terminal in native mode with a formatted screen, the SMI 
character and transaction code must be the first data characters 
in the data stream. If the transaction code calls for a 
compatibility transaction, the screen is formatted for 2260 
compatibility but no data is presented to the transaction. 

4. Always clear the screen before initiating a CICS transaction. 
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3735 PROGRAMMING CONSIDERATIONS (Not applicable to CICS/DOS-ENTRY) 

SYSTEM GENERATION 

BTAMDEV=3735D and ANSWRBK=EXIDVER must be included in the DFHSG 
PROGRAM=TCP macro instruction during system generation if support for 
the 3735 Programmable Buffered Terminal is to be generated for switched 
lines. 



TERMINAL CONTROL TABLE PREPARATION 

FEATURE=AUTOANSR must be specified in the DFHTCT TYPE=LINE macro 
instruction for all terminals on switched-line networks. To support 
the 3735 Programmable Buffered Terminal, the following must also be 
specified: 

1. DFHTCT TYPE=LINE,ANSWRBK=EXIDVER. 

2. BTAM DFTRMLST macro instruction of the form: SWLST,AN; the user 
portion of each 3735 DFTRMLST entry must point to the 
corresponding TCTTE. 

3. DFHTCT TYPE=TERMINAL,TRMTYPE=3735. 

If FEATURE=A0TOCALL is specified in the DFHTCT TYPE=LINE macro 
instruction, the following must also be specified: 

1. BTAM DFTRMLST macro instruction of the form: SWLST,AD. 

2. DFHTCT TYPE=TERMINAL,TRMADDR=name, and for batch input, 
TRANSID=name. 



INQUIRY MODE 

CICS deletes the inquiry header on input and inserts it on output. 
Therefore, inquiry applications require that: 

1. A single output record is transmitted. 

2. The output block does not exceed 233 bytes (plus a three-byte 
inquiry header) . 

3. The output data stream does not contain characters which are 
invalid for a 37 35. (See the 373 5 Programmer's Guide, 
GC30-3001.) 

If multiple inquiries are required in a single connection on a 
switched line, the user must make provision in his DFHTEP program to 
keep the line open. To accomplish this he may check for the IOERROR 
- TIMEOUT condition, a WRITE TR or READ TQ instruction, and TCTTEMIQ 
set to a hexadecimal blank character (X'UO 1 ) in TCTTEMCI. 

CICS/TCAM INTERFACE CONSIDERATIONS 

Most independent teleprocessing applications require a dedicated 
network. The Telecommunications Access Method (TCAM) permits multiple 
applications to share a single network, resulting in more efficient 
use of terminals and lines. The CICS/TCAM Interface enables CICS to 
run as an application under TCAM. 

TCAM is an optional access method that may be used alone or in 
combination with other access methods currently supported (BTAM, BSAM, 
and BGAM) . 
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One practical use of the CICS/TCAM Interface is to run a "production" 
CICS in one region and a "test" CICS in another. Running in separate 
regions, the applications are protected from one another. Operating 
under TCAM, terminals and lines can be shared by the two CICS 
applications. Other TCAM applications such as the Time Sharing Option 
(TSO) can also be running concurrently. 

In most cases, CICS user tasks that run under BTAM can run under 
TCAM without modification to the task code. This assumes that the user 
has properly designed and coded his TCAM Message Control program (MCP) . 
Modifications to his CICS Terminal Error program (DFHTEP) are required 
to take advantage of the new error codes used in the CICS/TCAM 
Interface. 

There are basic differences between TCAM and BTAM design methods. 
CICS was designed to operate in the BTAM environment. The CICS/TCAM 
Interface, although resolving most of the differences, must impose some 
restrictions when CICS is run in a TCAM environment. These restrictions 
as well as some of the ramifications of selecting various user options 
are addressed in this section. Also described are the user facilities 
available and how the user implements and operates his system via the 
interface. 

TCAM APPLICATION PROGRAM INTERFACE 

The TCAM Application Program Interface is a portion of the TCAM 
Message Control program (MCP) . It consists of two types of control 
blocks, the Process Control Block (PCB) and the TPROCESS block. 

The PCB defines the application program interface of a 
partition/region in the system using TCAM. Its purpose is to control 
communication and storage protection across partition/region boundaries. 
It also defines the user-written message handler (MH) responsible for 
processing messages to and from the application program. Since a PCB 
is required for each application program running with the MCP, a PCB 
is required to define the CICS application program. 

The TPROCESS control block controls communication to and from the 
application program. A separate block is required for both input and 
output to the application program. The application program is 
frequently referred to in TCAM as the Message Processing program (MPP) . 
A TPROCESS block is required for each input queue to CICS and for each 
output queue from CICS. In CICS there are corresponding Terminal 
Control Table line entries (TCTLE's) for each input queue and for each 
output queue (that is, for each TPROCESS block) . 

DD cards (such as those shown in Figure 11) are used to correlate 
the TCAM control blocks with the CICS control blocks. The CICS Terminal 
Control Table contains the DCB. The DDNAME specified in the Terminal 
Control Table macro instruction (DFHTCT TYPE=SDSCI,DDNAME=name) names 
the DD card. In the DD card, the QNAME field names the TCAM TPROCESS 
block. 

No exceptions are required for CICS to the TCAM Application Program 
Interface just described. For additional information, refer to the 
TCAM Programmer's Guide and Refe ren ce Manual (GC30-2024) . 
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MCP (TCAM) 



MPP (CICS) 



APPLICATION 
MESSAGE HANDLER 



STARTMH 




Figure 11. DD card correlation of TCAM and CICS control blocks 

CICS/TCAM INTERFACE 

A TCAM input process queue is considered to be a "line" to CICS. 
For each input process queue there is a CICS Terminal Control Table 
line entry (TCTLE) . Note that TCAM requires the application program 
(CICS) to have a DCB for each TPROCESS block; separate TPROCESS blocks 
are required for input to and output from the application. Therefore, 
each TCAM output process queue is also considered to be a line and has 
a corresponding CICS TCTLE. Each TCTLE references its own DCB generated 
by the DFHTCT TYPE=SDSCI macro instruction in CICS. 



The CICS Terminal 
the terminals associ 
each physical termin 
TCTTE containing the 
a TCTLE. Duplicatin 
the output TCTLE is 
the input TCTLE and 
TCTLE. Although att 
input and output pro 



Control Table terminal entries (TCTTE' s) define 
ated with a particular line entry (TCTLE) . For 
al communicating with CICS via TCAM, a corresponding 

terminal identification must be associated with 
g individual TCTTE* s for both the input TCTLE and 
avoided by attaching a single, special TCTTE to 
attaching all the individual TCTTE' s to the output 
ached to the output TCTLE, they are used for both 
cessing. 



Each input record from TCAM must contain the source terminal 
identification (OPTCD=W specified in the CICS DFHTCT TYPE=SDSCI macro 
instruction) . Using this identification as a search argument, the 
corresponding TCTTE can be located by CICS. 

Using the POOL feature (POOL=YES of the DFHTCT TYPE=LINE macro 
instruction), it is possible to establish a pool of common TCTTE' s on 
the output TCTLE that do not contain terminal identifiers. As required, 
terminal identifiers* are assigned to the TCTTE' s or removed from 
association with the TCTTE* s. This POOL feature necessarily imposes 
a number of restrictions and should be thoroughly understood before 
being implemented. For additional information, see the discussion of 
the POOL operand. 
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Dat a Format 

When TCAM is specified, CICS assumes that the user transaction data 
passed to it from the TCAM queue is in the proper format to be passed 
directly to the user task. Except for the removal of the source 
terminal identification, CICS does not alter the data it receives. It 
is the user's responsibility (via his MCP) to properly prepare the 
data, such as translating to EBCDIC, stripping line control characters, 
and deblocking. The user may optionally bypass the CICS routine that 
removes the source terminal identification by returning from the 
user-written input exit (XTCMIN) in TCP with a displacement of zero 
bytes. 

Similarly, CICS assumes that the user transaction data passed to it 
for TCAM has been properly formatted for direct placement on the TCAM 
output process queue. Except for the insertion of the destination 
identification and the device-dependent control character, CICS does 
not alter the data it receives. It is the user's responsibility (via 
his MCP) to properly prepare the data for the destination terminal, 
such as translating and inserting line control characters. 

Log ic Flow 

Below is a generalized description of the sequence of events that 
occurs in CICS when interfacing with TCAM. 

INPUT STEP ACTION 

A TCAM notifies CICS that it has data for a 

particular input TCTLE by posting its ECB. 

B CICS gets a TIOA and attaches it to the 

special input TCTTE in the TCTLE. 

C CICS issues a READ to TCAM which results in 

TCAM passing the data over the partition or 
region boundaries to the CICS TIOA. CICS 
indicates at this time that it has data to 
process. (See Figure 12.) 

D The input TCTLE points to the corresponding 

output TCTLE in response to the OUTQ 
specification of the DFHTCT TYPE=LINE 
macro instruction. 

E The individual TCTTE 1 s on the output TCTLE 

are searched for a matching source terminal 
identification. If POOL=YES has been 
specified, a free TCTTE is assigned to this 
source terminal identification. 
(See Figure 13.) 

F If an input user exit (XTCMIN) has been 

specified, CICS links to the user exit routine 
where the user may edit his input data prior 
to passing it to his task. (See the dis- 
cussion of XTCMIN in the section "TCAM User 
Exits".) 

If no exit has been specified, CICS removes 
the eight-byte source terminal identification 
field inserted by TCAM. No other editing of 
the data is performed. 
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INPUT STEP 



ACTION 



TCAM INPUT 
PROCESS QUEUE 




A check is made to determine whether a task 
is attached to the individual TCTTE. If not, 
go to Step H. 

If a task is attached, a check is made to see 
if the task has issued a READ. If a READ 
request exists, go to Step J. If not, CICS 
halts the processing of data in the queue 
until the TCTTE becomes available or the 
attached task issues a READ. 

CICS attaches the appropriate task. A user 
exit is available prior to the actual attach. 
(See the discussion of XATTACH in the 
section "TCAM User Exits".) 

If the task could not be attached (e.g., a 
"maximum task" or "short on storage" 
condition exists) , CICS remembers it has data 
to process and exits DFHTCP. On the next 
scan, it again tries to attach the task. 

Once a task is attached, CICS stores the 
TCAM segment identifier in the TCTTE (if 
segment processing was specified by including 
the C parameter in the OPTCD operand of the 
DFHTCT TYPE=SDSCI macro instruction) . 

CICS passes control to the attached task. 



TIOA 



Figure 12. CICS issues a TCAM read 
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TCAM INPUT 
PROCESS QUEUE 




(ABC) 



TIOA 




Figure 13. After TCAM read CICS attaches TIOA to corresponding TCTTE 



OUTPUT STEP 
A 

B 



ACTION 

The user issues a WRITE request in his 
application program. 

The TCP terminal scan recognizes the WRITE 
request. 

CICS checks to determine if an output user exit 
(XTCMOUT) has been specified. If specified, 
CICS links to the user exit routine where the 
user may edit his output data prior to passing 
it to TCAM. (See the discussion of XTCMOUT 
in the section "TCAM User Exits".) 

CICS checks the four-byte TCTTE field 
TCTTEDES for a destination saved as a result 
of DEST=NAME or DEST=YES having been specified 
in the DFHTC TYPE=WRITE macro instruction. 
If present, CICS inserts it in the eight- 
byte destination field and left justifies the 
field, padding blanks to the right. Otherwise, 
CICS moves the source terminal identification 
from the TCTTE to the destination field. 

CICS moves a one-byte communication control 
character into the ninth byte of the TCAM work 



1U2 



OUTPUT STEP ACTION 

area. See the section "Device Dependent 
Considerations". 

F CICS issues a TCAM WRITE to transfer the data 

to TCAM. 

G After checking for successful completion of 

the WRITE to TCAM, CICS posts the user task 
"dispatchable" if a task is still attached 
to the TCTTE. Otherwise, CICS frees the 
TCTTE for a new task. 

Terminal Error Program 

The CICS/TCAM Interface implementation has resulted in the expansion 
of the CICS Terminal Error program (DFHTEP) error codes and conditions 
previously existing in CICS. The additional codes and conditions are 
described in the section "Creating a Terminal Error Program (DFHTEP) ". 

Me ssag e Routing 

The DEST operand of the DFHTC TYPE=WRITE macro instruction can be 
used to route an output message to a destination defined by the user 
in the TCAM MCP. This operand can be used to send a message to a 
destination other than the source terminal (such as to another terminal, 
a list of terminals, or another application) . 

If DEST=name is specified, "name" is stored in the four-byte field 
TCTTEDES. If DEST=YES is specified, it is the user 1 s responsibility 
to have placed the destination name in TCTTEDES prior to issuing the 
WRITE macro instruction. 

CICS moves the data from TCTTEDES into the destination identification 
field prior to placing the data on the TCAM output process queue. The 
user may bypass the CICS routine that inserts the destination field by 
taking the XTCMOUT user exit and returning to CICS from the exit with 
a displacement of zero. In this case the user must ensure that the 
TCAM header is properly formatted for output. 

If the DEST operand is omitted, CICS inserts the source terminal 
identification from the TCTTE into the destination identification field. 

Segment Processi ng 

The CICS/TCAM Interface supports the TCAM segment processing 
capability. It permits segments of a message to be forwarded to CICS 
rather than waiting for the entire message to be received. If the user 
specifies segment processing (by including the parameter "C" in the 
OPTCD operand of the DFHTCT TYPE=SDSCI macro instruction) , CICS passes 
the segment to the user and places the one-byte position field control 
byte in the TCTTE field labeled TCTTETCM. Similarly on output, the 
user must supply the control byte in TCTTETCM for CICS to pass to TCAM. 
For additional information on segment processing, refer to the 
discussion of the OPTCD operand of the application input and output 
DCB in the OS/MFT and OS/MVT TCAM Programmer,' s Guide (GC30-2024) . 
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Line Pool Specification 

In generating the TCAM Message Control program the user defines each 
physical terminal to TCAM by means of a TCAM TERMINAL macro instruction. 
Since CICS also reguires terminal definitions, the user must prepare 
a Terminal Control Table terminal entry (TCTTE) for each terminal 
through use of the DFHTCT TYPE=TERMINAL macro instruction. As a result, 
a one-for-one correlation exists between terminal definitions in TCAM 
and in CICS. 

In a highly restricted environment, this duplication of terminal 
definitions can be reduced through use of the POOL feature (DFHTCT 
TYPE=LINE,POOL=YES) . Instead of a one-for-one relationship, a "pool" 
of generalized TCTTE 1 s is defined for a TCAM process gueue (line). 
When a transaction is received over the TCAM "line", a search is made 
for an available TCTTE in the pool. When one is found, it is assigned 
the source terminal identification for the duration of the task. Upon 
completion of the task, the TCTTE is available for reassignment. If 
there are no available TCTTE' s to handle the next transaction from the 
line, the line remains locked until a TCTTE becomes available through 
task completion. The number of TCTTE' s in the pool influences the 
degree of multitasking. 

Because the TCTTE' s are not permanently assigned, the use of the 
POOL feature is possible only in a restricted environment. The POOL 
feature is applicable only for those applications in which each record 
received over the input process gueue is a new transaction. Thus, the 
user should thoroughly analyze his environment before specifying the 
POOL=YES option in the DFHTCT TYPE=LINE macro instruction. 

Line Pool Restri cti o ns 

The following are line pool restrictions of which the user must be 
aware: 

1. Only one terminal type is permitted per TCAM line (process gueue) 
because of certain device dependencies within CICS. 

2. Tasks attached from transactions over the TCAM line are not 
permitted to issue Terminal Control READ reguests. This includes 
GET, PAGE, and CONVERSE because they contain implied READ'S. 
Violation of this restriction can cause a permanent line lock 

on the input process gueue, thereby preventing any further 
transactions on the gueue from reaching CICS. 

3. Segment processing reguires multiple READ'S which can cause a 
permanent line lock. Therefore, segment processing (OPTCD=WUC) 
must not be specified. 

4. Automatic task initiation is not applicable in the pool 
environment. 

5. Statistics are accumulated for each TCTTE in the pool; however, 
the statistics cannot be correlated to the physical terminals. 

6. Only one sign on can exist for all terminal entries in a given 
line pool at any one time. The first sign on received by CICS 
is propagated to all terminals in the pool. Any subseguent sign 
on is rejected. A sign off clears the sign-on data from all 
terminal entries in the pool; a subseguent sign on is then 
accepted. 

7. Master terminal functions reguire multiple READ'S and cannot, 
therefore, be used on terminals with pooled TCTTE »s. 
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Line Locking 

Line locking of two types can occur: (1) a temporary lock that 
resolves itself in time, and (2) a permanent lock that remains permanent 
unless the user takes action in his Terminal Error program. Adherence 
to the pool restrictions outlined in the previous topic should eliminate 
the permanent lock situation. 

A temporary line lock occurs when no TCTTE* s are available in the 
pool and a new transaction appears on the input queue. CICS locks the 
queue until an existing task completes execution, thus freeing a TCTTE. 
In this case, the completion of existing tasks is not dependent upon 
additional input from the queue. 

A permanent line lock can occur when multiple reads are required to 
complete a task. For example, assume that there are two TCTTE's in 
the pool, that a task is attached to each, and that the segments in 
the input queue are in the following order: 

1. Segment #1 for a third transaction 

2. Subsequent segments for the two active tasks 

Since no TCTTE is available in the pool for the third transaction, 
it must wait for a task to complete for a TCTTE to become available. 
Because the TCAM input queue is processed sequentially, tasks 1 and 2 
are unable to receive their subsequent segments. Hence, they cannot 
complete, and the queue remains permanently locked (because line pool 
restriction 2 of the previous topic was not observed) . 

2.1L§ His Considerations 

Since a queue is a sequential data set, the second record on the 
queue cannot be retrieved until the first record has been processed. 
To keep records flowing smoothly through the queue, it is essential 
that each record be processed as soon as it arrives. In the CICS/TCAM 
Interface, "processing the record" means detaching the TIOA (containing 
the record) from the special input TCTTE and attaching it to the 
individual TCTTE correlated to the actual physical terminal. Each 
individual TCTTE may be considered to be a "destination" for the purpose 
of this discussion. 

If a particular destination (TCTTE) is not ready to accept the 
current record on the queue, the queue necessarily "locks" until the 
destination can accept the record. Queue locks are only a problem when 
a queue is serving more than one destination. Then, if a queue locks, 
any new transaction on the queue or data records queued for existinq 
tasks are not processed until the required destination has accepted 
the current record. 

Since queue locks can adversely affect system performance, it is 
important that the user understand their cause and effect. Proper 
configuration of TCAM process queues and CICS Terminal Control Tables, 
reduces to a minimum the occurrences and duration of queue locks. 

Because TCAM can read ahead from the terminals, it is possible for 
TCAM to present to CICS a new transaction record destined for a TCTTE 
that is already processing a task. Also, TCAM can present a data record 
for an existinq task prior to that task issuing a READ request. In 
either case, CICS cannot "process" the record (as described above) 
until the TCTTE is ready to accept the new TIOA. Such input is called 
"unsolicited input". 

Three conditions can produce unsolicited input: (1) the CICS terminal 
for which the data is destined is OUT OF SERVICE, (2) the CICS terminal 
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for which the data is destined is in RECEIVE status, or (3) the CICS 
terminal for which the data is destined has an associated task that 
has not issued a READ and the period of time indicated by the NPDELAY 
specification has expired. In all cases, the action taken by the 
CICS/TCAM Interface is to place the input line OUT OF SERVICE and attach 
DFHTACP to process the error condition. 

The default action taken by DFHTACP (which can be altered by 
user-written DFHTEP) for conditions 1 and 2 is to discard the data and 
place the input line IN SERVICE. No default action is taken by DFHTACP 
for condition 3; therefore, the input line remains OUT OF SERVICE, 
thereby preventing CICS from reading any subsequent records from the 
input queue. 

To allow processing of input to continue, DFHTEP must take 
appropriate action. If the input line is placed IN SERVICE by DFHTEP, 
the CICS/TCAM Interface retries the operation; in this case, a count 
mechanism is recommended in DFHTEP to prevent a loop in the event the 
task never issues a READ. Alternative action, perhaps when a count 
limit is reached, might be to abend the task, dispose of the data, and 
place the line IN SERVICE. For further information concerning DFHTEP, 
see the section "Creating a Terminal Error Program". 

The problem of unsolicited input can be eliminated entirely by having 
a separate TCAM input process queue for each CICS terminal (TCTTE) . 
However, as the number of terminals increases, this solution may quickly 
become prohibitive in terms of main storage requirements. 

The user should analyze the type of traffic he anticipates over the 
queues. If he uses a 2770 Data Communication System or 2780 Data 
Transmission Terminal to read in volumes of cards, he should consider 
separate queues for these devices. The Asynchronous Transaction 
Processing (ATP) function in CICS should be seriously considered for 
processing batches of data to minimize the time between task READ 
requests. For conversational traffic with short-lived tasks, the 
sharing of queues is certainly feasible. The same TCAM output process 
queue can be specified for multiple input process queues. (See the 
discussion of the DFHTCT TYPE=LINE,OUTQ=symbolic name specification in 
the section "System Table Preparation".) 

The user need not be concerned with locking of the TCAM output 
process queue since TCAM requeues the data by final destination once 
it arrives over the output queue. 

It is possible for the TCAM output process queue to become congested 
due to lack of queuing space. In this case, CICS has a WRITE to the 
queue outstanding until TCAM accepts the data. 

TCAM DEVICE CONSIDERATIONS 

In the non-TCAM environment, the CICS Terminal Control program is 
responsible for polling and addressing terminals, code translation, 
transaction initiation, task and line synchronization, and the line 
control necessary to read from or write to a terminal. When TCAM is 
specified. Terminal Control relinquishes responsibility to the TCAM 
MCP for polling and addressing terminals, code translation, and line 
control. To take advantage of TCAM facilities, the user must accept 
the responsibility of coding in the MCP Message Handler functions such 
as code translation previously handled by the CICS Terminal Control 
program. 

For some terminal services, it is necessary for CICS to pass the 
user request on to the TCAM MCP Message Handler. A communication 
control byte in the TCAM work area has been established for this 
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purpose. It is passed to TCAM along with the eight-byte destination 
name field. Based on the communication byte, the user must execute 
the proper MCP Message Handler macro instructions to accomplish the 
necessary function. 

The terminal services parameters that do not set bits in the 
communications byte are WRITE, READ, WAIT, and SAVE. Bits in the 
communications byte are set for the 2260 parameters WRITEL and READL, 
the 2760 parameter 010, and the DISCONNECT parameter. 

The CICS/TCAM Interface does not support the RESET parameter or the 
3270 parameters READB and COPY. 

All messages to TCAM from CICS are prefixed with the standard 
CICS/TCAM communication byte. This byte is used to convey to TCAM 
reguest functions that cannot be issued within CICS (such as WRITEL to 
a 2260). Reguest functions maintained are DISCONNECT (X'08«), READL 
(XM0'), and WRITEL (X'20«). 

T CAM/22 60 Dev ice Cons ider ations 

The following CICS screen control macro instructions are passed to 
the TCAM Message Control program (MCP) : 

1. DFHTC TYPE=WRITE,LINEADR=number 

2. DFHTC TYPE=WRITE,LINEADR=YES 

3. DFHTC TYPE= (WRITE, ERASE) 

These macro instructions are passed in the following format: 



8 Bytes 



Destination 



I 



Start of message 

Line addressing character (if 
specified) 

Screen control (1 byte): 
X'AO 1 , Set WRITE direct 
X^BO', LINEADR reguest 
X'E0», ERASE reguest 

Standard communication byte that 
heads all messages to TCAM 



For a 2848 Control Unit Model 21 or 22, the communication byte is 
used to transmit READL and WRITEL reguests to be executed by the TCAM 
MCP. 
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TCAM/3270 Device Considerations 

Messages passed to CICS from TCAM are of the following format: 



8 Bytes 



I 



Destination 



Message 

Cursor (2 bytes) 
-Aid (1 byte) 



Messages passed from CICS to TCAM are of the following format: 



8 Bytes f 



— 



I 



Destination 



-Message 

-WCC (Write Control Character) 

- Command 

- Escape character 

- Standard CICS-to-TCAM 
communication byte 



All SOH% status messages input to CICS are passed to DFHTACP/DFHTEP. 

DFHTC TYPE=COPY and DFHTC TYPE=READB are not supported by the 
CICS/TCAM Interface. 

In addition to normal read/write functions, the ERASEAUP, CTLCHAR, 
UCTRAN, and COMPAT operands are also valid for the 3270. 

TCAM USER EXITS 

The three user exits applicable to the TCAM user are XATTACH, XTCMIN, 
and XTCMOUT. Whereas XATTACH is shared by other users, XTCMIN and 
XTCMOOT are applicable only to TCAM users and are used in place of the 
XINPUT and XOOTPUT exits used by others. See the section "Creating 
User Exits for CICS Management Programs" for further information 
concerning CICS user exits. 

Task Attach User Exit (XATTACH) 

This operand is used to generate linkage in the Terminal Control 
program TCAM module in TCP to a user-written exit routine. The linkage 
is generated at the point prior to issuing a Task Control ATTACH for 
a transaction identification received in response to polling. In the 
CICS/TCAM Interface this information is received over the TCAM input 
process queue. 
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Input User Exit (XTCMIN) 

This operand is used to generate linkage in the Terminal Control 
program TCAM module to a user-written exit routine. The linkage is 
generated at the point following the completion of any input event. 
If specified, the linkage is executed after the individual TCTTE is 
located, just before CICS checks to see if a task is attached to the 
TCTTE. At this time the TIOA contains the 12-byte storage accounting 
field and the work area from TCAM. The work area contains an eight-byte 
source terminal identfication header and the work unit (user data) . 
TIOADBA points to the user data area. 

The user has two options in returning from the user exit. If the 
user returns with a displacement of four bytes (an Assembler B 4(14) 
instruction) , CICS removes the eight-byte source terminal identification 
field. Upon completion, the TIOA contains the 12-byte CICS storage 
accounting field and the work unit. (See Figure 14.) 

If the user returns from the exit with a zero displacement (an 
Assembler B (14) instruction) , CICS does not alter the data in the 
TIOA. It is then the user's responsibility to handle the TCAM header. 

For a discussion of TCAM work areas and work units, refer to the 
section "Defining the Application Program Work Area" in the OS/MFT and 
O S/M VT TCAM Programmer's Guide (GC30-2024) . 

Output User Exit (XTCMOUT) 

This operand is used to generate linkage in the Terminal Control 
program TCAM module to a user-written exit routine. The linkage is 
generated for output events at the point prior to placing data on the 
TCAM output process queue. 

The user has two options in returning from the exit. If the user 
returns from the exit with an Assembler B 4(14) instruction, CICS 
inserts in the TIOA, between the 12-byte CICS storage accounting field 
and the work unit, a TCAM header consisting of an eight-byte destination 
field and a one-byte communication control character required for TCAM. 
If the user returns from the exit with an Assembler B 0(14) instruction, 
CICS bypasses this insertion routine. It is then the user's 
responsibility to ensure that the TCAM header is properly formatted. 

Figure 14 shows the composition of the TCAM Work Area and the CICS 
Terminal Input/Output Area (TIOA) at the various stages of operation. 
On input, it shows the information available from the TCAM input process 
queue, the TIOA after input event completion, and the TIOA as it is 
passed to the user task after CICS has edited out the origin field. 
On output, it shows the TIOA (after CICS has edited in the destination 
field) in the format in which it is placed on the TCAM output process 
queue. 

The TCAM origin field contains the source terminal identification 
field. Since CICS uses four-byte Terminal ID'S, the name is 
left- justified and the field is padded to the right with four blanks. 

Note : The TCAM destination field contains the destination 
identification for TCAM to properly route the data. 

If the user specifies the output user exit and returns from the exit 
with a zero displacement, CICS does not alter the TIOA work area. The 
user must provide the data length at TIOATDL and must prepare the work 
area for TCAM, including the eight-byte destination field and the 
communication control byte. 
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Figure 14. Stages of the TCAM work area and CICS terminal input/output 
area (TIOA) 

CICS/TCAM STARTUP 

The TCAM MCP must be in operation prior to completing CICS system 
initialization. When the user brings up CICS with the CICS/TCAM 
Interface, CICS checks for the presence of a TCAM partition/region and 
issues the operator message: 

DFH1500 -< CICS CHECKING FOR TCAM MCP 

If CICS discovers the MCP is not operational, the following messages 
are issued: 

DFH1520 - TCAM MCP IS NOT CURRENTLY AVAILABLE 
DFH1520 - REPLY RETRY OR CANCEL OR CONTINUE 

The operator must then respond: 

RETRY 
when the TCAM partition/region becomes active; or 

CANCEL 
to terminate CICS; or 

CONTINUE 

to continue initialization of CICS in the absence of the TCAM partition/ 
region. 
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If the operator responds CONTINUE, all DD cards that reference a 
TCAM queue must have been previously removed from the startup deck to 
avoid an abnormal termination of CICS. The CONTINUE response is 
applicable to a mixed BTAM/TCAM mode of operation when TCAM lines are 
not being used during execution of CICS. 

CICS/TCAM ABEND/RESTART 

If the TCAM Message Control program (MCP) terminates abnormally, 
any TCAM application programs currently active are automatically 
terminated abnormally, providing there is at least one open line group 
in the MCP. The CICS application program is no exception. For further 
information, see the discussion concerning "Coordinating MCP and 
Application Program Restarts" in the OS/MFT and O S/M VT TCAM Programmer's 
Guide (GC30-2024) . CICS does not provide RESTART capability." 

CICS/TCAM TERMINATION 

CICS is terminated in the normal manner. No modifications to 
termination procedures are required to support the CICS/TCAM Interface. 
If both CICS and TCAM are being terminated, CICS ahould be terminated 
first to avoid an abnormal termination of CICS. 
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SYSTEM ADMINISTRATION 



REAL-TIME SYSTEM ADMINISTRATION 

Administration of a real-time data base/data communications (DB/DC) 
system involves considerations not ordinarily applicable to the 
traditional batch processing environment. These real-time DB/DC 
considerations include: 

1. Multiple application environment, often involving common or 
related data bases 

2. Managing data centrally on behalf of all applications 

3. Transactions arriving on a random nonscheduled basis for 
asynchronous (concurrent) processing upon arrival 

4. Transaction processing sometimes of long duration (for example, 
continuous 24-hour operation) 

5. Communication across multiple time zones (sometimes involving 
foreign as well as domestic interstate communication) 

6. Interface with multiple vendors of data processing services and 
equipment 

It is the responsibility of the system administrator to deal 
creatively with these new dimensions and complexities in data 
processing, seeing to it that the system is "tuned" for optimum 
performance and service. 

SYSTEM CONTROL FUNCTIONS 

The dynamics of the data base/data communication (DB/DC) environment 
make it necessary to be able to change system control parameters. 
Certain of the parameters are changeable, if allowed by the system 
administrator or by the supervisor and terminal operators. Those 
facilities and the considerations for invoking them are described in 
the Term ina l Operator's Gu ide (SH20-1044) . The primary system control 
is provided through the master terminal. 

The master terminal function is a logical rather than a physical 
consideration. This function can be invoked from any terminal that 
the system administrator allows, but is intended for use by a master 
terminal operator. In addition to the administrative terminal 
facilities described in the Termina l Operator's Gui de, the master 
terminal may alter other system parameters that control the performance 
of the system. These control parameters are to be changed in the 
day-to-day operation of the system to effect the desired performance. 
They can also be changed in the process of tuning the system to obtain 
optimum performance under differing conditions. 

The terminal administration facilities are described in the Terminal 
Operator's Guide . The system administration functions intended for 
exclusive use from a master terminal are described below. 

MASTER TERMINAL 

The Master Terminal program is a conversational program that leads 
the user through each transaction if sufficient information to perform 
the requested service was not entered in the original data entry. 

The services provided by the Master Terminal program allow the master 
terminal operator to: 
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1. Inquire about or change the partition exit time interval value. 

2. Inquire about or change the runaway task interval value. 

3. Inquire about or change the stall detection interval value. 

4. Inquire about or change the storage cushion size. 

5. Inquire about or change the maximum number of tasks value. 

6. Inquire about or change the maximum number of batch tasks value. 

7. Inquire about or change the maximum number of ATP tasks value. 

8. Inquire about or change the negative poll delay for a terminal. 

9. Inquire about or change the trigger level or a transient data 
intrapartition data set. 

10. Turn the CICS Trace function on or off. 

11. Inquire about or change the status of a single terminal. 

12. Change the status of a list of terminals. 

13. Change the status of a class of terminals. 

14. Change the status of all the terminals in the system. 

15. Inquire about or change the status of a line. 

16. Inquire about or change the status of a control unit. 

17. Inquire about or change the status of one or more data base 
data sets. 

18. Open one or more data base data sets. 

19. Open one or more transient data extrapartition data sets. 

20. Open the dump data set. 

21. Close one or more data base data sets. 

22. Close one or more transient data extrapartition data sets. 

23. Close the dump data set. 

24. Switch the dump data set to the alternate dump data set. 

25. Inguire about the status of a program. 

26. Terminate a task. 

27. Terminate CICS. 

System Partitions/Region Exit Time Interval 

The partition /region exit time interval is the maximum interval of 
time that CICS will release control to the operating system in the 
event there are no transactions ready to resume processing. This binary 
time interval can be any three-to-ten-digit decimal value in the range 
from 100 to 27962020 milliseconds. A typical range of operation might 
be 100 to 2000 milliseconds. 

Runaway Task Time Interval 

Any task given control through the Task Control program returns 
control to Task Control within a user-defined interval of time. Tasks 
not meeting this time requirement are considered to be in a runaway 
(logical loop) state and are deleted from the system. This binary time 
interval can be any three-to-ten-digit decimal value that is not less 
than the partition/region exit time interval and not greater than 
27962020 milliseconds. A typical runaway task time interval might be 
5000 milliseconds. If the runaway task time interval is set to zero, 
the feature is made inoperative. 

Stall Time Inter val 

If CICS remains in an overload condition for the duration of the 
stall time interval, it is assumed that a system stall exists and 
corrective action is initiated. This binary time interval can be any 
three-to-five-digit decimal value that is not less than the 
partition/region exit time interval and not greater than 32767 
milliseconds. A typical stall time interval might be 20000 
milliseconds. 
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Stor acje C ushion Size 

The system storage cushion is used by CICS to minimize system 
overload conditions. The cushion size does not actually change until 
the existing cushion is released. When the cushion is then regained, 
the cushion is of the size indicated by the new value. If a cushion 
size change is requested and the existing cushion is not released, the 
cushion size remains unchanged. The cushion size can be any 
two-to-five-digit decimal value (representing number of bytes) in the 
range from 20 to 65535. 

Negative Poll Delay 

The negative poll delay function allows the user of CICS to delay 
the polling of BTAM devices on a line when negative responses are 
detected. This facility allows some control over the CPU overhead 
required to service negative poll interrupts. The request must be made 
in milliseconds and has a range from to 20000. Once a terminal on 
that line enters into a conversational-mode transaction, that terminal 
receives a full poll until the transaction is completed. 

Maximu m Number of Ta sks 

CICS limits the number of tasks that can be in the system at any 

one time to the number indicated by this user-defined value. This 

value can be changed dynamically in the range from 1 to 999. In the 

CICS/DOS-ENTRY system, the maximum number of tasks cannot be changed 
dynamically since the Rollout facility is initialized at a specified 

number during system initialization and cannot change unless CICS is 
reinitialized. 

Co nsecu tive Dispatch Limit 

The consecutive dispatch limit is valid only in the CICS/DOS-ENTRY 
system. When a transaction has performed the number of input/output 
operations (other than terminal input/output) specified by the 
consecutive dispatch limit, a task switch is initiated by CICS. The 
consecutive dispatch limit can be any value between 1 and 999. 

Trigger Level 

If a Transient Data intrapartition data set is marked for automatic 
task initiation, CICS automatically initiates the task when the 
specified number of requests for output operations (indicated by the 
trigger level for that destination) have been issued for that 
destination. The trigger level can be any value between and 32767. 

Trace 

If the CICS trace function is not generated as part of the CICS 
nucleus, the trace function cannot be turned on. If the CICS trace 
function is generated as part of the CICS nucleus, turning it off does 
not remove it from the system; the trace function is still in main 
storage, but is not executed. 

Data Base Data Sets 

The status of data base data sets reflects one or more of the 
following: 
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1. Read 

2. Update 

3. Add 

4. Exclusive Control 



Dump Data Set 



Optionally, the user can define two dump data sets (DFHDMPA and 
DFHDMPB) , alternating between them during real-time execution of CICS. 
If there are two dump data sets, a 'switch* reguest closes the dump 
data set that is currently open and opens the other dump data set. 
This allows the user to print the CICS formatted dumps on the first 
dump data set without having to terminate CICS. 

Program Status 

The status of a program is comprised of the following: 

1. The language in which the program was written 

2. The size of the program in bytes 

3. Whether or not the program is permanently resident in main storage 

4. Whether or not the program is currently in main storage 

5. The number of times the program has been used 

6. The number of transactions that are currently using the program 

Dynamic Open/Close 

The optional CICS dynamic open/close facility allows the user to 
dynamically open/close his data sets as often as desired during the 
real-time execution of CICS. For example, this makes it possible for 
the user to defer the opening of data sets at System Initialization 
and open/close them later through the master terminal as they are 
needed. The dynamic open/close capability is applicable to File 
Management (data base data sets) , Dump Management (dump data sets) , 
and Transient Data Management (extrapartition data sets) . Those 
CICS/DOS extrapartition sequential disk data sets that are to be closed 
and re-opened by the dynamic OPEN/CLOSE function of the Master Terminal 
Program must be defined as nonresident or records may be lost. 

Terminate a Task 

The only time a task is not terminated upon request is when the 
requested task is currently reading from or writing to a terminal. 

System Termination 

CICS can be terminated from the master terminal by entering the 
transaction identification: 

CSMT 
The system responds: 

WHAT SERVICE IS REQUESTED? 
The master terminal operator should enter: 

SHUTDOWN 
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The system will respond: 

IS SHUTDOWN TO BE IMMEDIATE? 

The operator can respond with one of the following: 

NO 

NO, DUMP 

YES 

YES, DUMP 

If the system is to be terminated without regard to the existence 
of any active transactions (tasks), the operator should enter 'YES 1 . 
If the operator wishes to wait until there are no active transactions 
in the system, he should respond •NO". 

Note: If the user of the CICS/DOS-STANDARD system requests immediate 
termination of CICS while active transactions are communicating 
with terminals, unpredictable results could occur; that is, 
active terminals could receive input/output data from other 
active terminals within CICS. 

If the master terminal operator wishes to receive a main storage 
dump upon completion of the termination process, he should respond 
either »YES,DUMP» or 'NO, DUMP*. 

If immediate termination is not requested, if Asynchronous 
Transaction Processing (ATP) is being used, and if there are batches 
currently in a HOLD status, the operator must respond: 

CATP STOP 

to complete the quiescing process. 

When termination is initiated, the following message is displayed 
on the system console and on the master terminal: 

DFH1701 - CICS IS BEING TERMINATED 

When termination is complete, the following message is displayed on 
the system console: 

DFH1702 - NORMAL TERMINATION COMPLETE 

If a dump is requested, the following message is displayed on the 
system console when termination is complete: 

DFH1791 - ABNORMAL TERMINATION COMPLETE 

DATE AND TIME OF DAY CONTROL 

In the course of normal operation, CICS maintains the current date 
and time of day within the Common System Area (CSA) . The current 
(Julian) date of the form YYDDD is maintained in packed decimal 
representation at CSAJYDP, where YY is years and DDD is days. The 
current time of day is maintained in three formats: (1) in packed 
decimal at CSATODP of the form HHMMSSS, where HH is hours, MM is 
minutes, and SSS is seconds to tenths of a second, (2) in binary decimal 
at CSACTODB to hundredths of a second, and (3) in binary decimal timer 
units at CSATADJT to 300ths of a second. The current date is initially 
set by the CICS System Initialization program to agree with the date 
maintained by the operating system. The time of day values are updated 
during task dispatching to reflect the time of day maintained by the 
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operating system. The accuracy of these values depends upon the task 
mix and frequency of task switching occurrences. 

Since the time of day maintained by the operating system can be 
changed either by the operating system (for example, OS resetting the 
clock to zero at midnight) or by the console operator, CICS must 
recognize the situation where a "negative" change in the time of day 
has occurred, and must adjust expiration times maintained by CICS 
accordingly. 

If the optional time adjustment feature of CICS Time Management is 
not included in CICS, any change to the operating system time of day 
involving midnight is represented by CICS as a value larger than the 
previous value (for example, 1:00 a.m. is represented as 2500 hours); 
the date remains unchanged. If the optional time adjustment feature 
is included in CICS (by including the ICPTIME=YES operand in the DFHSG 
PBOGRAM=ICP specification) , and if either the time-ordered task 
synchronization feature or automatic task initiation feature of CICS 
Time Management is also included, any change to the operating system 
time of day is automatically reflected in the expiration times 
maintained by CICS; the date maintained by CICS is reset to agree with 
the data maintained by the operating system. 

In the case of CICS/OS, when the operating system time of day is 
set to zero at midnight (and the time adjustment feature has been 
included in CICS), CICS/OS adjusts the expiration times of day it 
maintains, changes the date, and then resets its time of day to zero. 
In the case of both CICS/OS and CICS/DOS, when the operating system 
time of day is changed by the console operator to a value less than 
the previous value, CICS adjusts the expiration times it maintains to 
reflect the negative value and then resets its date and time of day to 
those values maintained by the operating system. The optional time 
adjustment feature thus makes it possible for CICS to be operated on 
a continuous round-the-clock basis. 

The optional time adjustment feature is included in CICS by 
generating the Time Adjustment program (DFHTAJP) as part of the Control 
System Operational group (CSO) . The user must provide a corresponding 
entry in the Processing Program Table (PPT) and the appropriate 
Transaction Identification (CSTA) as an entry in the Program Control 
Table (PCT) referencing DFHTAJP. 

When a negative change in the time of day maintained by the operating 
system is detected by CICS, transaction CSTA is automatically initiated. 
A message is then sent to the console operator informing him that the 
CICS time of day has been changed to reflect the change in the time of 
day maintained by the operating system. 

CICS does not recognize a change to just the date field. However, 
if transaction CSTA is initialized after the date maintained by the 
operating system has been changed, the date maintained by CICS is 
updated accordingly. 

SYSTEM STATISTICS 

Statistics maintained by the various CICS management programs can 
be displayed during the day in part or in their entirety on the request 
of any terminal operator whose security code allows the request of such 
information. 

Statistics are transmitted to the Transient Data destination CSSL 
as variable-length, unblocked records (maximum block size equal to 136) 
when the system is normally terminated or when requested by the terminal 
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operator. When requested by a terminal operator, an alternate 
destination may be specified. 

To request all system statistics, the following transaction is 
entered by the terminal operator: 

CSTT AOR destid 

To request selected statistics, the following transaction is entered 
by the terminal operator: 

CSTT SOR destid label, label, label, DONE 

The 'destid 1 is used to specify the four-character destination 
identification to which statistics are to be sent. If this field is 
blank (consisting of six blank characters between "SOR" and "label") , 
CSS1 is the default destination. 

The •label 1 corresponds to any of the following labels which request 
a particular set of statistics. 

LABEL SET OF STATISTICS 

TERM Terminal statistics 

PROG Program statistics 

FILE File statistics 

TASK Task statistics 

STOR Storage statistics 

DUMP Dump statistics 

TRAN Transient data statistics 

TEMP Temporary storage statistics 

DYNAMIC OPEN/CLOSE FUNCTION 

The optional CICS Dynamic Open/Close facility allows the user to 
dynamically open/close his data sets as often as desired during the 
real-time execution of CICS. This makes it possible for the user to 
defer the opening of data sets during system initialization and 
open/close them later as they are needed. The dynamic open/close 
capability is applicable to File Management (data base data sets). Dump 
Management (dump data sets) , and Transient Data Management 
(extrapartition data sets) and may be invoked via the Master Terminal 
program or through the use of the DFHOC macro instruction in an 
Assembler language application program. 

For a discussion of open/close via the Master Terminal program, see 
the section "Master Terminal" in this publication. 

The Open/Close macro instruction (DFHOC) is used to reguest any of 
the following services: 

1. Open, close, or switch dump data sets. 

2. Open or close data base data sets. 

3. Open or close transient data extrapartition data sets. 

Note: The DFHOC macro instruction is intended for use by the system 
programmer as a means of system control; it should not be used 
by the application programmer to open/close his data sets , as 
improper use of this macro instruction can cause serious 
degradation of system performance. 

The following operands can be included in the DFHOC macro 
instruction: 
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DFHOC TYPE=OPEN, * 

DATASET=TRANSDATA, DATABASE, DUMP, * 

LISTADR= (register) , (symbolic register) , YES, * 

SYMBADR=symbolic address, * 

DSETID= (name, (xx) ,. „.) , * 
CHECK=symbolic address 

DFHOC TYPE=CLOSE, * 

DATASET=TRANSDATA, DATABASE, DUMP, * 

LISTADR= (register) , (symbolic register) , YES, * 

SYMBADR=symbolic address, * 

DSETID= (name,. . .) , * 
CHECK=symbolic address 

DFHOC TYPE=SWITCH, * 

DATASET=DUMP 

OPEN DATA SETS (OPEN) 

The programmer can open a data set or series of data sets by issuing 
the 

DFHOC TYPE=OPEN, * 

DATASET=TRANSDATA,DATABASE,DUMP, * 

LISTADR= (register) , (symbolic register) , YES, * 

SYMBADR=symbolic address, * 

DSETID= (name, (xx) ,. . .) , * 
CHECK=symbolic address 

macro instruction. He must provide the parameters needed by specifying 
them in the macro instruction or, in the case of LISTADR, by placing 
the address of the parameter list (built by the user) in the TCA at 
TCAOCLA and specifying IISTADR=YES. 

A discussion of the operands that can be included in the DFHOC 
TYPE=OPEN macro instruction follows. 

DATASET: Specifies whether the request is for a transient data 
extrapartition data set (TRANSDATA) , a data base data set (DATABASE) , 
or a dump data set (DUMP) . 

LISTADR: Specifies the register or symbolic register name containing 
the address of the open/close parameter list built by the user. If 
LISTADR=YES is specified, this address can be placed in the TCA at 
TCAOCLA. If the LISTADR operand and SYMBADR operand are omitted, 
execution of the DFHOC macro instruction causes the list to be built 
for the user starting with the first byte of the TWA. In this case, 
it is the user's responsibility to make sure that the required space 
is available in the TWA. The space can be calculated using the formula: 

Space = (n x 12) +4 

where "n" is the decimal number of twelve-byte entries in the open/close 
parameter list and the "4" represents four bytes of hexadecimal F's to 
signify the end of the parameter list. 

The symbolic storage definition (DFHOCLDS) of a parameter list entry 
is provided by CICS. The format of a twelve-byte entry in the 
open/close parameter list is: 
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TRANSDATA 

WORD 1: Four-byte Destination ID. 

WORD 2: Four bytes of the form bbxx where bb is two bytes of 
blanks and xx is a two-byte suffix of the data set 
control block created by the DCT assembly. 

WORD 3: Error byte plus three-byte address of DCT entry (after 
completion) . 

DATABASE 

WORDS 1 and 2: 

Data set name (left justified, padded with blanks) . 
WORD 3: Error byte plus three-byte address of FCT entry (after 

completion) . 

In CICS/OS, the user can optionally specify, in WORD 2 of a TRANSDATA 
entry, the parameter list address pointing to a storage area. This 
storage area contains information to be placed into a dummy DCB before 
opening it. If an address is placed in this field, the first byte must 
be set to a hexadecimal FF. The symbolic storage definition (DFHOCODS) 
of this parameter list is provided by CICS. The format of the parameter 
list is as follows: 

Byte 1: Open Options byte 

Byte 2: BDFNO byte 

Byte 3: RECFM byte 

Byte 4: ERROPT byte 

Bytes 5,6: LRECL 

Bytes 7,8: BLKSIZE 

Bytes 9-16: DDNAME 

The first eight bytes must contain the correct hexadecimal codes for 
the desired parameters, since the 16 bytes of the open/close parameter 
list are moved into the DCB. 

SYMBADR: Not applicable if DATASET=DUMP is specified, this operand 
indicates the symbolic address of an open/close parameter list built 
by the user. If the SYMBADR and LISTADR operands are omitted, execution 
of the DFHOC macro instruction causes the parameter list to be built 
for the user starting with the first byte of the TWA. For a discussion 
of the parameter list, see the discussion of the LISTADR operand in 
this section. 

DSETID: Not applicable if DATASET=DUMP is coded or if the LISTADR or 
SYMBADR operand is used, this operand specifies the data set names or 
destination identifications to be used in constructing a parameter 
list. If a suffix is specified, it must be separated from the name or 
destination identification by a comma and must be enclosed in 
parentheses . 

If DATASET=DATABASE is coded, up to 255 data set names can be 
specified with a single use of the DSETID operand. If DATASET=TRANSDATA 
is coded, up to 255 destination identifications can be specifed with 
a single use of the DSETID operand. If TYPE=OPEN is coded and if the 
destinations are nonresident, "xx", a two-character suffix of the data 
set control block (DCB for CICS/OS, DTF for CICS/DOS) must be provided 
with each destination identification; if the destination is resident, 
the "xx" suffix is ignored. 

In CICS/OS, if "xx" consists of more than two characters, it is 
assumed to be the symbolic address of a list of options and parameters 
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to be moved into the DCB. For the format of this list, see the 
discussion of the LISTADR operand in this section. 

CHECK: Specifies the symbolic address of a user-written routine to 
which control is passed if any error is detected during the OPEN 
operation. The user-written routine is given control whenever TCAOCTR 
in the TCA contains a nonzero return code. It is the responsibility 
of the user to examine the return code in the TCA and, if necessary, 
examine the individual error codes in the list that was built either 
by the user or by the expansion of the DFHOC macro instruction. The 
error code appears in the first byte of the third word of each entry 
in the parameter list. 

Upon return from the Dynamic Open/Close program, TCAOCTR may contain 
one of the hexadecimal codes: 

00 - No error 

FF - Invalid reguest 

or, if TCAOCTR contains neither of these codes, it will contain one or 
more of the following hexadecimal codes: 

80 - Open error 

40 - Close error 

20 - No space available for OPEN 

10 - Invalid control block name 

While performing the reguested service on the list of data sets, 
the individual error bytes in the list entry are filled with a 
hexadecimal 00 or with the proper error code each time an error is 
encountered. If more than one error is encountered while processing 
the parameter list, TCAOCTR reflects all the errors and may show a bit 
configuration different from those shown above. For example, if there 
are six data sets to be opened, if four are successfully opened, if 
one has an invalid control block identification, and if one has an open 
error, the TCAOCTR field contains a hexadecimal 90. 

When there is not enough main storage available to open any data 
sets, TCAOCTR contains a hexadecimal 20, and all the entries contain 
a fullword (four bytes) of zeros in the third word. 

CLOSE DATA SETS (CLOSE) 

The programmer can close a data set or series of data sets by issuing 
the 

DFHOC TYPE=CLOSE, * 

DATASET=TRANSDATA, DATABASE, DUMP, * 

LISTADR= (register) , (symbolic register) , YES, * 

SYMBADR=symbolic address, * 

DSETID= (name,. . .) , * 
CHECK=symbolic address 

macro instruction. The DATASET, LISTADR, SYMBADR, and CHECK operands 
have the same significance as for the DFHOC TYPE=OPEN macro instruction. 
The DESTID operand is used as follows. 

DSETID: Specifies the names of the data sets to be closed. No suffix 
is required. Op to 255 data set names can be specified with a single 
use of this operand. 
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SWITCH DUMP DATA SETS (SWITCH) 

The programmer can switch from the dump data set currently being 
used to the alternate dump data set by issuing the 

DFHOC TYPE=SWITCH, * 

DATASET=DUMP 

macro instruction. This macro instruction causes the current dump data 
set, if open, to be closed, and the alternate dump data set to be 
opened. A TYPE=CLOSE,DATASET=DUMP macro instruction does not cause a 
switch but only closes the current dump data set. 

CONTROL SYSTEM MESSAGES 

During the course of CICS execution, certain exceptional conditions 
can occur of which system administration should be aware. These 
conditions cause control system messages to be sent to appropriate 
destinations through the CICS Transient Data Control facility. The 
user interested in this information should direct it to the desired 
gueue or log by defining the appropriate entries in the Destination 
Control Table (DCT) . 

Although these control system messages may be routed to an 

extrapartition output log, it is strongly recommended that the user 

route them to a terminal (preferably hard copy) so that appropriate 
administrative action can be taken. 

Control system messages that originate in the Terminal Abnormal 
Condition program (DFHTACP) are time stamped; that is, the time that 
the exceptional condition occurred is printed as part of the message. 
The time is expressed in the form "hhmmsss", where "hh" represents 
hours, "mm" represents minutes, and "sss" represents seconds to tenths 
of a second. Control system messages that originate in the Abnormal 
Condition program (DFHACP) are not time stamped. 

The system actions described in connection with the following 
messages are the default actions provided by DFHTACP. These system 
actions are subject to modification by the user-written Terminal Error 
program (DFHTEP) . 

In the CICS/DOS-ENTRY system, it is not always possible to determine 
the transaction identification. Therefore, in the following message, 
the program identification (PROG yyyyyyyy) may be substituted for the 
transaction identification in the case of the CICS/DOS-ENTRY system. 

1. TCT SEARCH ERROR ON LINE W/TERM xxxx, hhmmsss 

TCT SEARCH ERROR ON LINE W/TERM xxxx, RELATIVE LINE zz, hhmmsss 

Destination: CSMT 

Explanation: BTAM input only. An invalid terminal address was 
received for a read operation on a line defined by terminal 
xxxx. If the line supports the TWX, relative line zz is also 
printed. 

System Action:, Terminal request for service is ignored and the 
data which was input is lost. The line associated with terminal 
xxxx is placed out of service on non-switched lines; the system 
continues polling other lines. On remote 2260 terminals, the 
control unit skip flag is turned on in the polling list and the 
line continues in service. 
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Pro gramme r Action; Examine the Terminal Control Table to be 
sure there is an entry for every terminal on each line. 
Regenerate it to include a missing terminal. Bad transmission 
of data on remote 2260 terminals can cause this message to occur. 

2. TRANSLATE ERROR AT TERM xxxx, TRANS yyyy, hhmmsss 
TRANSLATE ERROR ON LINE W/TERM xxxx, hhmmsss 

TRANSLATE ERROR ON LINE W/TERM xxxx, RELATIVE LINE zz, hhmmsss 

Destination: CSMT 

Explanat ion : BTAM. Terminal type for Terminal Identification 
xxxx is not present in the Terminal Control Table, or the 
Terminal Control program was not generated to support the device 
type specified in the Terminal Control Table. 

S yste m Ac tio n: Request for service is ignored and the data is 
lost. The system continues polling. Terminal xxxx is put out 
of service. 

Pr og rammer Action: Regenerate the Terminal Control Table to 
provide the correct terminal type, or regenerate the Terminal 
Control program to support the required terminal type. 

3. POLLING LIST ERROR ON LINE W/TERM xxxx, hhmmsss 

Desti nati on: CSMT 

Exp lanation : The address for a terminal identified as xxxx in 
the Terminal Control Table does not correspond to the polling 
list. 

System Action^ The system continues processing. Terminal xxxx 
is put out of service. 

Programmer Actio n: Examine the Terminal Control Table and 
polling list for discrepancies. If the assemblies of each are 
correct, check to see if the program has inadvertently affected 
either the table or the list. Correct the error and either 
regenerate the table or resubmit the program. 

U. OUTPUT EVENT REJECTED AT TERM XXXX, TRANS yyyy, RETURN CODE ZZ, 
hhmmsss 

Destination: CSMT 

Expla nation^ BTAM output only. The return code zz was generated 
by BTAM when the write was attempted. 

Sy stem Action: The line (defined by terminal xxxx) is placed 
out of service, and the transaction yyyy is abended. 

Programmer Action: Take appropriate action as determined from 
the BTAM return code. 



INPUT EVENT REJECTED AT TERM XXXX, TRANS yyyy, RETURN CODE ZZ, 

hhmmsss 

INPUT EVENT REJECTED ON LINE W/TERM xxxx RETURN CODE zz, hhmmsss 

INPUT EVENT REJECTED ON LINE W/TERM xxxx, RELATIVE LINE aa, 

RETURN CODE zz, hhmmsss 
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Desti nati on: C S M T 

Ex£lanationj. BTAM input only. Return code zz was generated by 
BTAM when the READ was attempted. 

S yst em Action^ The line defined by terminal xxxx and relative 
line aa (for switched lines) is placed out of service. The 
transaction yyyy is abended. 

Programmer Ac tio n; Take appropriate action as determined from 
the BTAM return code. 

6. TCT CODING OR TCP PROGRAM ERROR AT TERM xxxx, TRANS yyyy, hhmmsss 
TCT CODING OR TCP PROGRAM ERROR ON LINE W/TERM xxxx, hhmmsss 

TCT CODING OR TCP PROGRAM ERROR ON LINE W/TERM XXXX, RELATIVE 
LINE aa, hhmmsss 

Desti nati on: CSTL 

Explanation: Generated as a result of a BTAM return code of 04 
(BUSY), OC (invalid OPTYPE) , or 10 (AOTOPOLL or program polling 
error) . 

System Action,: None. 

Programmer Action: To further analyze the BTAM READ/WRITE return 
code, see the publication OS/360 B asi c Telecommunications Access 
Mihod, Version 2 (GC30-2004) . 

7. OPEN FAILURE, USE LOPEN TO RECOVER ON LINE W/TERM xxxx, hhmmsss 
OPEN FAILURE, USE LOPEN TO RECOVER ON LINE W/TERM xxxx, RELATIVE 
LINE aa, hhmmsss 

Destination: CSTL 

Explanation:. Generated as a result of BTAM return code 14 (line 
error during OPEN) . 

System Action:, None. 

Programmer Action:, Use the Master Terminal facility to place 
the line in service. 

8. MISSING DD CARD ON LINE W/TERM xxxx, RELATIVE LINE aa, hhmmsss 

Destination: CSTL 

Explanation: Generated as a result of BTAM return code 08 
(invalid RLN) . This error most commonly occurs as a result of 
omitting one of the DD cards of a switched-line pool. 

System Action: None. 

Pr ogr ammer Ac tio n: Ensure that all DD cards for a switched- 
line pool are present in the job stream used to bring up CICS. 

9. SHOULD NOT OCCUR RETURN CODE zz AT TERM xxxx, TRANS yyyy, hhmmsss 
SHOULD NOT OCCUR RETURN CODE zz ON LINE W/TERM XXXX, hhmmsss 
SHOULD NOT OCCUR RETURN CODE zz ON LINE W/TERM XXXX, RELATIVE 
LINE aa, hhmmsss 
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Desti nati on:, CSTL 

Explanation: Generated as a result of BTAM return codes 18, 
1C, or 20. These return codes are undefined for CICS and 
indicate that the DCB probably contains dynamic buffering 
operands. 

System Action^ None. 

Pr ogramme r Ac ti on: Ensure that no buffering operands exist in 
the DCB for the line involved. 

10. BUFFERED DEVICE BUFFER EXCEEDED AT TERM xxxx, TRANS yyyy, hhmmsss 

Destination: CSTL 

Explanation: On a device with the buffer receive feature (for 
example, the 2740-2) , the output message length exceeded the 
hardware buffer size. > < 

System Act i on: The write reguest is aborted, the terminal write 
storage is freed (if possible) , and the task is abended. 

Programmer Action: Ensure that the data length plus the carrier 
control characters does not exceed the hardware buffer size. 

11. OUTPUT LENGTH ZERO AT TERM xxxx, TRANS yyyy, hhmmsss 

Desti nati on: CSMT 

Explana t ion: A write was requested on terminal xxxx by 
transaction yyyy, but the contents of the TIOATDL field was 
zero. 

S yst em Action^ The write reguest is aborted, the terminal write 
storage is freed (if possible) , and the task is abended. 

Programmer Ac ti on:. Ensure that the transaction in error 
initializes th"e TIOATDL field of the TIOA. 

12. NO OUTPUT AREA PROVIDED AT TERM xxxx, TRANS yyyy, hhmmsss 

Desti nati on: CSTL 

Explanation: A write was reguested on terminal xxxx by 
transaction yyyy; the TCTTEDA field was not initialized. 

S yst em Action: The write reguest is aborted and the task is 
abended. 

Programmer Action:, Ensure that the transaction in progress 
obtains necessary storage and initializes the TCTTEDA field, as 
necessary. 

13. OUTPUT AREA EXCEEDED AT TERM XXXX, TRANS yyyy, hhmmsss 
2§§iiljation.L CSTL 

Ex pla nation: The Terminal I/O Area (TIOA) was not large enough 
to contain both the data and carrier control characters. 
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System Ac tion:, The write request is aborted, the terminal write 
storage is freed (if possible) , and the task is abended. 

P rogramm er Action: Ensure that the transaction in error obtains 
TIOA's large enough to contain messages in addition to carrier 
control characters. 

14. UNIT CHECK AT TEEM xxxx, TRANS yyyy, hhmmsss 
UNIT CHECK ON LINE W/TERM xxxx, hhmmsss 

UNIT CHECK ON LINE W/TERM XXXX, RELATIVE LINE ZZ, hhmmsss 

Destin ati on: CSMT 

Explanation: A unit check error occurred on the line defined 
by terminal xxxx, transaction yyyy, and relative line zz (as 
appropriate) . 

System, Action: The line is placed out of service on GAM or SAM 
lines and on BTAM I/O errors (with the exception of Intervention, 
Data Check, or Time Out error conditions) . 

Intervention on a switched line causes the task to be abended 
and the line to be logically disconnected. Intervention on a 
non-switched line with a dummy (unidentified) terminal causes 
the line to be placed out of service; with a real terminal, 
causes the terminal to be placed out of service and the 
transaction (task) to be abended. 

Data check with a dummy terminal causes the line to be placed 
out of service; with a real terminal, causes the terminal to be 
placed out of service and the transaction to be abended. 

Time Out on a Read Text command causes a MESSAGE TOO LONG 
response to be sent to the terminal. Time Out with a dummy 
terminal causes the line to be placed out of service; with a 
real terminal, causes the terminal to be placed out of service 
and the transaction to be abended. 

Programmer Acti on:. Examine the System Console Log message 
generated by BTAM for this error and have the unit error 
corrected. 

15. UNIT CHECK SHOULD NOT OCCUR AT TERM xxxx, TRANS yyyy, hhmmsss 
UNIT CHECK SHOULD NOT OCCUR ON LINE W/TERM xxxx, hhmmsss 
UNIT CHECK SHOULD NOT OCCUR ON LINE W/TERM xxxx, RELATIVE 
LINE zz, hhmmsss 

Destination: CSMT 

Explanation: A unit check error (which is undefined by BTAM) 
occurred on the line defined by terminal xxxx, transaction yyyy, 
and relative line zz (as appropriate) . 

Sistem_Actionj. The line is placed out of service on GAM or SAM 
lines and on BTAM I/O errors (with the exception of Intervention, 
Data Check, or Time Out error conditions) . 

Intervention on a switched line causes the task to be abended 
and the line to be logically disconnected. Intervention on a 
non-switched line with a dummy (unidentified) terminal causes 
the terminal to be placed out of service and the transaction 
(task) to be abended. 
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Data check with a dummy terminal causes the line to be placed 
out of service; with a real terminal, causes the terminal to be 
placed out of service and the transaction to be abended. 

Time Out on a Read Text command causes a MESSAGE TOO LONG 
response to be sent to the terminal. Time Out with a dummy 
terminal causes the line to be placed out of service; with a 
real terminal, causes the terminal to be placed out of service 
and the transaction to be abended. 

Programmer Action: Examine the System Console Log message 
generated by BTAM for this error and have the unit error 
corrected. 

16. UNIT EXCEPTION AT TERM XXXX, TRANS yyyy, hhmmsss 
UNIT EXCEPTION ON LINE W/TERM xxxx, hhmmsss 

UNIT EXCEPTION ON LINE W/TERM xxxx, RELATIVE LINE zz, hhmmsss 

Destination: C S M T 

Explanat ion : A unit exception error occurred on the line defined 
by terminal xxxx, transaction yyyy, and relative line zz (as 
appropriate) . This error was posted 41 by BTAM. 

S ystem Action: With a switched line, the transaction is abended 
and the line is logically disconnected. With a dummy terminal, 
the line is placed out of service; with a real terminal, the 
terminal is placed out of service and the transaction is abended. 

Programmer Action: Examine the System Console Log message 
generated by BTAM for this error and have the unit error 
corrected. 

17. UNIT EXCEPTION SHOULD NOT OCCUR AT TERM xxxx, TRANS yyyy, hhmmsss 
UNIT EXCEPTION SHOULD NOT OCCUR ON LINE W/TERM xxxx, hhmmsss 
UNIT EXCEPTION SHOULD NOT OCCUR ON LINE W/TERM xxxx, RELATIVE 
LINE zz, hhmmsss 

Destination: CSMT 

Explanation: A unit exception errror (undefined by BTAM) 
occurred on the line defined by terminal xxxx, transaction yyyy, 
and relative line zz (as appropriate) . 

System. Ac tion : With a switched line, the transaction is abended 
and the line is logically disconnected. With a dummy terminal, 
the line is placed out of service; with a real terminal, the 
terminal is placed out of service and the transaction is abended. 

Programmer Action: Examine the System Console Log message 
generated by BTAM for this error and have the unit error 
corrected. 

18. NEGATIVE RESPONSE AT TERM XXXX, TRANS yyyy, hhmmsss 
NEGATIVE RESPONSE ON LINE W/TERM XXXX, hhmmsss 

NEGATIVE RESPONSE ON LINE W/TERM xxxx, RELATIVE LINE ZZ, hhmmsss 

Destination: CSMT 

Explanation: An invalid negative response occurred on the line 
defined by terminal xxxx, transaction yyyy, and relative line 
zz (as appropriate) . 
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System Action ^ The terminal is placed out of service and the 
transaction is abended. 

Programmer Actio n: Examine the System Console Log message 
generated by BTAM for this error and have the unit error 
corrected. 

19. UNDETERMINED UNIT ERROR AT TERM XXXX, TRANS yyyy, hhmmsss 
UNDETERMINED UNIT ERROR ON LINE W/TERM XXXX, hhmmsss 
UNDETERMINED UNIT ERROR ON LINE W/TERM XXXX, RELATIVE LINE zz, 
hhmmsss 

Destin ati on: CSMT 

Expla n atio n: An I/O error (which was not unit check, unit 
exception, or negative response) occurred on the line defined 
by terminal xxxx, transacton yyyy, and relative line zz (as 
appropriate) . 

Syst em Action^ The line associated with terminal xxxx is placed 
out of service. 

Programmer Action:, Examine the System Console Log message 
generated by BTAM for this error and have the unit error 
corrected. 



20. SECURITY VIOLATION HAS BEEN DETECTED TERM ID-XXXX, TRANS ID=XXXX, 
OPERATOR NAME=XXXXXXXX 

Destination: CSMT 

Explanatio n: The operator at terminal xxxx has requested a 
transaction whose security key does not match the corresponding 
security key for the operator who is signed on. 

S yste m Action^ Continues polling cycle. * 

Programmer Action; Determine whether the operator should be 
allowed to request the transaction. If so, correct the security 
key for the operator in the Sign-on Table (DFHSNT) . 

21. INTERCEPT REQUIRED AT TERM xxxx, TRANS yyyy, hhmmsss 

Destination: CSMT 

Explanation: The task associated with terminal xxxx, transaction 
yyyy* and relative line zz (as appropriate) was to have been 
abnormally terminated, but TPURGE=N0 was specified in the 
corresponding entry of the Program Control Table (PCT) . 

System Action: The terminal is placed out of service. 

Pro gram mer Action: Use the Master Terminal facility to intercept 
or terminate the task. 
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22. TRANSACTION XXXX ABEND xxxx AT xxxx 



Destination: CSMT 

Explana ti on:. The identified transaction attached to the 
identified terminal has been abnormally terminated. The ABEND 
code indicates the origin or cause, and may be originated by 
the user or by CICS. Following are the ABEND codes for abnormal 
terminations initiated by CICS. 



Code 
AACA 

AICA 



D et ect i ng Program Cause 



Abnormal Condition 



Interval Control 



AKCA 



Task Control 



Invalid error code passed to DFHACP 
in the TCA at location TCAPCABR. A 
complete system dump is provided to 
assist in problem determination. 

A runaway task condition has been 
detected and the task is being 
abnormally terminated. The condition 
indicates a possible logical loop 
within the user's program. 

Another CICS task has reguested Task 
Control to abnormally terminate this 
task as a result of actions initiated 
by: 

• Terminal Abnormal Condition program 
(DFHTACP) ; the appropriate message 
is found at destination CSMT. 

• Task Termination portion of 
the Master Terminal facility. 

The Asynchronous Transaction Control 
program (DFHATP) terminates 
asynchronous tasks when: 



User reguests delet 
via CWTR delete opt 
is actively process 
DFHATP abnormally t 
task and purges all 
from the gueues. 
An asynchronous tas 
more data than is a 
DFHATP abnormally t 
task. 



ion of a batch 
ion while CICS 
ing that batch; 
erminates the 
remaining data 

k tries to read 
vailable; 
erminates the 



AKCD 



Task Control 



AKCP 



Task Control 



Invalid code in the dispatch control 
indicator field. The invalid code 
can be found in the TCA at symbolic 
location TCATCDC. Valid Codes: 
X'10' Not dispatchable (not 

applicable to CICS/DOS-ENTRY) 

Dispatchable 

Wait on list of events 

Wait on single event 



X»20» 
X«40« 
X«80« 



A stall condition has been detected 
and this task is being abnormally 
terminated. This task carries a 
code indicating it is purgeable. 
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Code Detecting Program 
AKCR Task Control 



ARCS 



APCC 



APCI 



APCL 



APCP 



APCR 



Task Control 



Program Control 



Program Control 



Program Control 



Program Control 



Program Control 



APCT 



APIA 



A SCR 



Program Control 



Program Interrupt 



Storage Control 



Cause 

The type of reguest code is invalid. 
The invalid code can be located in 
the TCA at symbolic location TCATCTR. 
Valid Codes: 

X»01* Engueue 

X'02' Degueue 

X»04' Reserved 

X'08' Reserved 

XMO* Task Origination 

XM1' Reserved 

X'12 1 Reserved 

XM4 1 Reserved 

X^O 1 Priority Change 

X'40» Task Wait 

X'SO* Task Termination 

The reguest exceeds available Subpool 
1 storage. CICS/DOS-ENTRY only. 

An attempt was made to execute an 
ANS COBOL program but ANS COBOL 
support was not generated in Program 
Control. 

An attempt was made to execute a 
PL/I program but PL/I support was 
not generated in Program Control. 

There is insufficient main storage 
available for the reguested program. 

An error occurred on the read of a 
reguested program from the library. 

Task reguest for service is invalid. 
The invalid code can be located in 
the TCA at TCAPCTR. Valid Codes: 

X'OV LINK 

X»02» XCTL 

X»04' LOAD 

X»08' DELETE 

XMO 1 RETURN 

X»40» ABEND 

X^O 1 ABEND with DUMP 

X^O* RETURN from Task 
Control program 

A task issued a reguest for a program 
which is not in the PPT. The invalid 
program ID is in the TCA at TCAPCPI. 

A program check has occurred during 
the subject task execution. The 
PSW at the time of interrupt is 
saved in the task , s TCA. 

The reguest for service is invalid. 
Valid codes: 

X*20' Released Storage 
X^O* Release Storage 
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C ode Det ectin g Progra m 



ASCT Storage Control 



ATDI Transient Data 



ATDT Transient Data 



DLDY DL/I Interface 



DLIA DL/I Interface 



DLPA DL/I Interface 



Cause 

X^O* Acquire Storage 

The request exceeds available Subpool 
1 storage. CICS/DOS-ENTRY only. 

The type of destination code is 
invalid. The invalid code can be 
located in the DCT at symbolic 
location TDDCTDT. Valid Codes: 

X«20« Indirect 
X'UO' Extrapartition 
X*80' Intrapartition 

Request for service is invalid. The 
invalid code is in the TCA and can 
be located at TCATDTR. Valid codes; 

X*20' Forced end of volume on 
extrapartition data set. 

X^O* Output service on 
intrapartition. 

X^O" Input service on 
intrapartition. 

A DL/I CALL was issued, but the DL/I 
Interface dummy program under CICS/OS 
was loaded at system initialization. 

An irrecoverable error occurred 
during execution of the CICS-DL/I 
Interface program under CICS/OS. 
The DLIA code is returned to all 
transactions from which DL/I CALL*s 
are subsequently issued. 

A DL/I abend (or pseudo abend) 
occurred during transaction 
processing. The ABEND code is found 
in the TCA at TCADLECB. 



S yste m Ac tio n: In addition to the dump services requested by 
application programs, CICS also requests dumps for abnormal 
conditions and places specific dump codes in the dumps for ready 
identification. 



A ctio n: 
code. 



Analyze the error condition indicated by the abend 



23. INVALID COPY REQUEST AT TERM XXXX, TRANS yyy, hhmmsss 
De stinati on: CSMT 

Expla nati on: 

a. The Terminal Control Table Terminal entry of the "from" 
device did not specify the COPY feature. 

b. The device address specified for the "from" device 
does not exist on the requested control unit. 

c. The length specified for the COPY request was not one. 
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System. Action: The transaction is abended. 

Programmer Action: Ensure that the application program is aware 
of the device configuration as necessary. 

24. INVALID MSG BLOCK ON LINE W/TERM XXXX, hhmmsss 
Destination: CSMT 

Explanation: 

a. An unidentifiable message was received from a remote 3270 
device. The message block did not correspond with known 
identification patterns. 

b. The type of data block received from a 3735 was incorrect 
for the mode of the active CICS transaction. For example 

an inquiry message block was received for a batch transaction 
or conversely. This will probably occur if the 3735 is 
disconnected during a transaction and, upon reconnection, 
the operator initiates a different mode of operation. 

System Action: The terminal is placed out of service and the 
transaction is abended. 

Programmer Action: For condition (a) , ensure that the hardware 
difficulty is corrected. For condition (b) , ensure that the 
terminal operator understands the correct operating and recovery 
procedures for 3735 transactions. 

25. INCMPLT MSG BLOCK ON LINE W/TERM xxxx, hhmmsss 
INCMPLT MSG BLOCK AT TERM XXXX, TRANS yyyy, hhmmsss 

Destination: CSMT 

Exp lanati on: An incomplete message was received on term xxxx; 
that is, end of transmission was received prematurely or prior 
to end of text. 

Sv^teji_ActionjL The terminal is placed out of service and the 
transaction is abended. 

gSQgg^flfflQg-AgtJ-pn: Ensure that the hardware difficulty is 
corrected. 

26. INTERV ON PRINTER ON LINE W/TERM xxxx, hhmmsss 
INTERV ON PRINTER AT TERM XXXX, TRANS yyyy, hhmmsss 

Destination: CSMT 

Explanation^ This message is sent to the 3270 Information 
Display System on a printer intervention situation: 

a. Normal out of paper condition, cover open, offline, etc. 

b. No printer present, but transaction request to start printer. 

c. Printer adapter feature not present. 

System^ Action: No action is performed. 

Programmer Action: Ensure that the Terminal Control Table is 
properly defined and that the transaction requests proper printer 
operations. If the 3277 Display Station is plugged in the wrong 
position on the 3270 Information Display System, the operator 
may depress the CLEAR key to proceed. 
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27. INTERV REQUIRED ON LINE W/TERM xxxx, hhmmsss 
INTERV REQUIRED AT TERM XXXX, TRANS yyyy, hhmmsss 

De stinati on: CSMT 

Ex planati on: This message occurs when an intervention situation 
arises on the 3270 Information Display System. 

System Action: No action is performed 

Pro grammer Actio n: Correct the intervention situation. 

28. ERROR STATUS MSG eeee RECEIVED ON LINE w/TERM xxxx, hhmmsss 
ERROR STATUS MSG eeee RECEIVED AT TERM xxxx, TRANS yyyy, hhmmsss 

P. £ st ination: CSMT 

Explan ation: Error status message "eeee" was received from a 
remote 3270 Information Display System or from a 3735 
Programmable Buffered Terminal. For a remote 3270, an 
"intervention reguired" condition causes an INTERVENTION REQUIRED 
message in lieu of this message. 

System Action: The transaction is abended and the terminal is 
placed out of service; however, if operation check status is 
present and if the terminal is a 3270, the terminal is left in 
service. 

Programmer Action: Analyze the error status to determine the 
proper course of action to correct the unit error or program 
error. 

29. UNSOLICITED INPUT ONLINE W/TERM xxxx, hhmmsss 

Destination: CSMT 

Expl anatio n: Input has occurred on a control unit (general 
poll) for which the associated terminal is "out of service" or 
has a task that has not issued a DFHTC TYPE=READ macro 
instruction. 

Sy st em Action: No action is performed by CICS. Control is 
given to user-written DFHTEP. 

Pr ogramme r Action: Code DFHTEP as dictated by environmental 
needs. 

30. DESTINATION dddd INVALID ONLINE W/TERM xxxx, hhmmsss 
DESTINATION dddd INVALID AT TERM xxxx, TRANS yyyy, hhmmsss 

Destination: CSTL 

Ex planati on: An application program has attempted to write to 
an invalid TCAM destination. 

System A gtio n: Abend the transaction and abort the write 
reguest. 

P rogramme r Actio n: Ensure that application programs write to 
proper TCAM destinations. 
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31. INVALID READ REQUEST AT TERM xxxx, TRANS yyyy, hhmmsss 
Destination: CSMT 

Explanation; 

a. A transaction has requested a READ from a terminal that 
presently has a terminal status of RECEIVE. 

b. A transaction has issued a READ request to a 3735 terminal 
during batch transmission after receipt of the end-of-file 
(EOF) condition. 

System Action; Abort the READ request and abend the transaction. 

Pr ogramm er Action; For condition (a) , ensure that transactions 
do not issue DFHTC TYPE=READ macro instructions to terminals in 
RECEIVE status. For condition (b) , ensure that the 3735 batch 
transaction makes proper use of the EOF operand in the DFHTC 
macro instruction so that no reads are issued after the EOF 
condition has occurred. 

32. INVALID WRITE REQUEST AT TERM xxxx r TRANS yyyy, hhmmsss 
De stinat ion: CSMT 

Ex plan ation : 

a. A transaction has issued a WRITE to a terminal that presently 
has a terminal status of INPUT. 

b. A transaction has issued a WRITE to a 3735 during batch 
transmission prior to receipt of the 'EOF' condition. 

S ys tem Action: Abort the WRITE request and abend the 
transaction. 

Pr ogramme r Actio n: For condition (a) , ensure that transactions 
do not issue WRITE requests to terminals in INPUT status. For 
condition (b) , ensure that the 3735 batch transaction does not 
issue its first WRITE request before receivinq the EOF condition. 

33. TIME OUT ONLINE W/TERM xxxx, hhmmsss 

TIME OUT AT TERM xxxx, TRANS yyyy, hhmmsss 

Destination: CSMT 

Ex planat ion: A 32-second timeout has occurred on a 7770 Audio 
Response Unit. 

System Action: The 7770 terminal received an error message and 
is disconnected, and the transaction abended. 

Programmer Acti on: None 

34. DFHSF001 xxx yyyyy zzz 
Destination: CSML 

Explanation: The operator has signed off a terminal where: 

xxx = operator identification from Sign-on Table; 
yyyyy = number of transactions processed; 
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zzz = number of transaction errors. 

S yst em Actio n; CICS continues processing. The operator is no 
longer signed on the terminal. The message SIGN Of? IS COMPLETE 
is returned to the terminal. 

Programmer Action: None 
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APPENDIX Ai REQUIRED ENTRIES TO CICS CONTROL TABLES 



ENTRIES REQUIRED IN DESTINATION CONTROL TABLE (DCT) 

The following destination identification entries are required and 
must be provided by the user in the DFHDCT TYPE=EXTRA, DFHDCT 
TYPE=INTRA, or DFHDCT TYPE=INDIRECT specification: 



1. DESTID=CSMT 

2. DESTID=CSTL 

3. DESTID=CSSL 

4. DESTID=CSML 



The Terminal Abnormal Condition program (DFHTACP) 

and Abnormal Condition program (DFHACP) write 

terminal error and abend messages, respectively, 

to this destination. 

DFHTACP writes terminal I/O error messages to 

this destination. 

Statistics programs write data to this 

destination. 

Sign-off program outputs data to this 

destination. 



If the Transient Data Control program (DFHTDP) is not included in 
the generation of CICS, messages to these destinations are lost 
(ignored) . 

ENTRIES REQUIRED IN PROGRAM CONTROL TABLE (PCT) 

The following entries are required in the PCT and must be provided 
through the DFHPCT TYPE=ENTRY macro instruction. Minimum values for 
TWASIZE are indicated. 



TRANSID 



PROGRAM 



TWASIZE 



CAQP*** 

CATP*** 

CRDR*** 

CSAC 

CSFE** 

CSMT** 

CSOT** 

CSSF** 

CSSN** 

CSST** 

CSTA** 

CSTE 

CSTT 

CWTR*** 

8888* 

9999* 



DFHAQP 

DFHATP 

DFHRD1 

DFHACP 

DFHFEP 

DFHMTPA 

DFHMTPA 

DFHSNP 

DFHSNP 

DFHMTPA 

DFHTAJP 

DFHTACP 

DFHSTKC 

DFHWT1 

DFHSNP 

DFHSNP 



100 

100 

100 

40 

100 

160 

100 





100 





100 

160 







Note: Entries marked with a single asterisk are required only when 
numeric-only terminals are used to sign on. 

Entries marked with a double asterisk are required only when 
the associated program is desired. 

Entries marked with a triple asterisk are required only when 
the Asynchronous Transaction Processing facility is being used. 

Any transaction codes specified for the TRANSID parameter in any 
DFHTCT TYPE=TERMINAL macro instruction must also be included in the 
PCT. 
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Transaction code CSXX is reserved for 3270 support and should not 
be generated in the PCT. (CSXX is used to generate an "invalid 
transaction code" message when a zero length data message is received.) 

The user-assigned transaction security key for entries CSAC, CSSN, 
and CSSF must always be the value 1. 

A high priority (for example, 255) is recommended for transactions 
CSAC, CSTA, CSMT, CSOT, and CSST. A low priority (for example, 001) 
is recommended for transactions CSFE, CSSF, CSSN, and CSTT. 

CSMT, CSOT, and CSST do not run in 2260 compatibility mode. 
COMPAT=NO must be specified or the operand omitted. 



ENXSI1S 1JO. HIRED IN PROCESSING PROGRAM TABLE (PPT) 

The following entries are reguired in the PPT and must be provided 
through the DFHPPT TYPE=ENTRY macro instruction: 



PROGRAM NAME 

DFHACP 

DFHAQP 

DFHATP 

DFHBMSMM 



DFHFEP 

DFHMTPA 
DFHMTPB 
DFHMTPC 
DFHMTPD 
DFHMTPE 
DFHMTPF 

DFHOCP 



DFHRD1 
DFHRD2 



DFHSFP 

DFHSNP 

DFHSNT 

DFHSTKC 
DFHSTP 



USAGE 

Abnormal Condition program. 

Asynchronous Queue Purge program (reguired only 
if the Asynchronous Transaction Processing 
facility is being used) . 

Asynchronous Transaction Control program 
(reguired only if the Asynchronous Transaction 
Processing facility is being used) . 

Basic Mapping Support program (reguired only if 
3270 Basic Mapping support is desired) . 

Terminal Test program (optional) . 

Master Terminal program (reguired only if master 
terminal or system termination functions are 
desired) . 



Dynamic Open/Close program (reguired only if 
dynamic open/close facility is desired) . 

Asynchronous Transaction Input Processing 
programs (reguired only if the Asynchronous 
Transaction Processing facility is being used) . 

Sign-off program linked to by DFHSNP (reguired 
only if sign-on/sign-off function is desired) . 

Sign-on program (reguired only if sign-on/sign- 
off function is desired) . 

Sign-on Table (reguired only if sign-on/sign-off 
function is desired) . 

System Statistics program. 

System Termination program linked to by DFHMTP. 
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PROGRAM NAME 
DPHSTTD 

DFHSTTR 

DPHTACP 
DFHTAJP 

DFHTDCP 

DFHTEP 
DFHTENXX 



DFHWT1 
DFHWT2 



DFHXITxx 



User-specified 
name 



USAGE 

Transient Data and Temporary Storage Statistics 
program linked to by DFHSTKC. 

Terminal and Data Base Statistics program linked 
to by DFHSTKC. 

Terminal Abnormal Condition program. 

Optional Time Adjustment program that 
automatically adjusts the date and time of day 
maintained by CICS to reflect the date and time 
of day maintained by the operating system. 

Device-Dependent Output program for 1030 
terminals. 

Terminal Error program linked to by DFHTACP. 

non-resident data set control blocks as specified 
by the user in DCT. 

Asynchronous Transaction Output Processing 
programs (required only if the Asynchronous 
Transaction Processing facility is being used) . 

User-written exit routine used with Asynchronous 
Transaction Processing transactions CEDE and 
CWTB. 

User-written program to edit input data and 
transfer control to the appropriate transaction. 
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APPENDIX B: EXAMPLES OF TERMINAL CONTROL TABLE PREPARATION 



This section illustrates the coding required to prepare the CICS 
Terminal Control Table (TCT) . The terminal network described includes: 

1 . Start/stop transmission 

a. Multipoint line (serving more than one terminal) 

(1) 1030 Data Collection System 

(2) 2260 Display Station (remote) 

b. Point-to-point line (serving only one terminal) 

(1) 2740 Communication Terminal and 2760 Optical Image Unit 

(2) 2741 Communication Terminal with correspondence code 

c. Switched line (dial-up) 

(1) 7770 Audio Response Unit under CICS/OS 

(2) 7770 Audio Response Unit under CICS/DOS 

(3) Common Carrier Teletypewriter Exchange Terminal (TWX) 

2. Binary synchronous transmission 

a. Multipoint line (serving more than one terminal) 

(1) 2980 General Banking Terminal System 

(2) 3270 Information Display System (remote) 

b. Point-to-point (serving only one terminal) 
(1) 2780 Data Transmission Terminal 

c. Switched line (dial-up) 

(1) 2770 Data Communication System 

(2) System/3 

(3) 3735 Programmable Buffered Terminal (CICS/OS only) 

3. Transmission via sequential devices 

a. Card reader/line printer 

(1) 2540 Card Read Punch and 1403 Printer 

b. Disk 

(1) 2314 Direct Access Storage Facility 

4. Transmission via devices locally attached 
a. Graphics devices 

(1) 2260 Display Station (local) 

(2) 3270 Information Display System (local) 

Each of the following is a functional example if as shown in the 
first example, (1) the DFHTCT TYPE=INITIAL macro instruction is inserted 
at the beginning of each example, (2) the DFHTCT TYPE=FINAL macro 
instruction is inserted at the end of each example, and (3) an Assembler 
END card that includes the operand DFHTCTBA is inserted following the 
DFHTCT TYPE=FINAL macro instruction. 

1030 DATA COLLE C TION SYSTEM 

DFHTCT TYPE=SDSCI, * 

CU=2702, * 

DEVICE=1030, * 

LINELST=(024) , * 

SWITCH=NO, * 
DSCNAME=DTF1030 
OPL1030 DFTRMLST OPENLST, (64,62) 
DFHTCT TYPE=LINE, 

ACCMETH=BTAM, * 

TRMTYPE=1030, * 

DSCNAME=DTF1030, * 

BTAMRLN=1, * 
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LISTADR=OPL1030, * 
INAREAL=120 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=T30A, * 

TRANSID=1030, * 

TRMADDR=64, * 

TRMPRTY=202, * 
TRMSTAT=TRANSCEIVE 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=T30B # * 

TRANSID=1030, * 

TRMADDR=62, * 

TRMPRTY=201, * 

TRMSTAT=TRANSCEIVE, * 
LASTTRM=LINE 

2260 DISPLAY STATION (REMOTE) 

DFHTCT TYPE=SDSCI, * 

CU=2701, * 

DEVICE=2260, * 

LINELST=(026) , . ' * 

SWITCH=NO, * 
DSCNAME=DTF60R 
OPL2260 DFTRMLST OPENLST, (40FF,41FF) 

DFHTCT TYPE=LINE, * 

ACCMETH=BTAM, * 

TRMTYPE=2260, * 

TRMMODL=3, * 

DSCNAME=DTF60R, * 

BTAMRLN=1, * 

LISTADR=OPL2260, * 
INAREAL=960 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=R60A, * 

TRMADDR=40A0, * 

TRMPRTY=61, * 
TRMSTAT=TRANSCEIVE 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=R60B, * 

TRMADDR=40A1, * 

TRMPRTY=62, * 
TRMSTAT=TRANSCEIVE 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=R530, * 

TRMTYPE=1053, * 

TRMADDR=40A4, * 

TRMPRTY=32, * 
TRMSTAT=RECEIVE 

DFHTCT TYPE=TERMINAL r * 

TRMIDNT=R65A, * 

TRMTYPE=2265, * 

TRMADDR=4151, * 

TRMPRTY=64, * 

TRMSTAT=TRANSCEIVE, * 
LASTTRM=LINE 

2740 COMMUNICATION TERMINAL/2760 OPTICAL IMAGE UNIT 



DFHTCT TYPE=SDSCI, * 

CU=2703, * 

DEVICE=2740, * 

FEATURE=(CHK,OIU) , * 
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LINELST=(029) , 

SWITCH=NO, 

DSCNAME=DTF40B 

DFHTCT TYPE=LINE, 

ACCMETH=BTAM, 

TRMTYPE=27 40/2760, 

FEATURE=CHECKING, 

DSCNAME=DTF40B, 

INAREAL=120, 

BTAMRLN=1 

DFHTCT TYPE=TERMINAL, 
TRMIDNT=T40C, 
TRANSID=2760, 
TRMPRTY=202, 
TRMSTAT=TRANSCEIVE, 
LASTTRM=LINE 



2U71 COMMUNICATION TERMINAL 



DFHTCT TYPE=SDSCI, 
CU=2703, 
DEVICE=2741C, 
LINELST=(030) , 
SWITCH=NO, 
DSCNAME=DTF41C 

DFHTCT TYPE=LINE, 

ACCMETH=BTAM, 

TRMTYPE=2741C, 

DSCNAME=DTF41C, 

INAREAL=120, 

BTAMRLN-1 

DFHTCT TYPE=TERMINAL, 
TRMIDN?=T41A, 
TRMPRTY=129, 
TRMSTAT=TRANSCEIVE, 
LASTTRM=LINE 



7770 AUDIO RESPONSE UNIT UNDER CIC5/OS 

DCB DFHTCT TYPE=SDSCI, 
DEVICE=7770, 
DSCNAME=DCB7770, 
APPENDG=Z3 

L17770 DFHTCT TYPE=LINE, 

ACCMETH=BTAM, 

TRMTYPE=7770, 

DSCNAME=DCB7770, 

INAREAL=256, 

BTAMRLN=1, 

FEATURE=AUTOANSR, 

ANSWRBK=TERMINAL, 

CONVTAB=ABB, 

RDYMSG= READY, 

ERRMSG=ERROR, 

POOLADR=T17770 

L27770 DFHTCT TYPE=LINE, 

ACCMETH=BTAM, 

TRMTYPE=7770, 

DSCNAME=DCB7770, 

INAREAL=256, 

BTAMRLN=2, 

FEATURE=AUTOANSR, 

ANSWRBK=TERMINAL, 
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L37770 DFHTCT 



L47770 DFHTCT 



T17770 DFHTCT 



T27770 DFHTCT 



T37770 DFHTCT 



T47770 DFHTCT 



READY 
ERROR 



DFHTCT 

DFHTCT 



CONVTAB*ABB, 

RDYMSG'READY, 

ERRMSG^ERROR 

TYPE=LINE, 

ACCMETH-BTAM, 

TRMTYPE-7770, 

DSCNAME=DCB7770 f 

INAREAL-256, 

BTAMRLN*3, 

FEATURE^AUTOANSR, 

ANSWRBK*TERMINAL, 

CONVTAB^ABB, 

RDYMSG*READY, 

ERRMSG*ERROR 

TYPE^LINE, 

ACCMETH^BTAM, 

TRMTYPE=7770, 

DSCNAME=DCB7770, 

INAREAL-256, 

BTAMRLN=4, 

FEATURE*AUTOANSR, 

ANSWRBK=TERMINAL, 

CONVTAB~ABB, 

RDYMSG-READY, 

ERRMSG-ERROR 

TYPE=TERMINAL, 

TRMIDNT-7771, 

TRMPRTY=30, 

TRMTYPE*7770, 

TRMSTAT^TRANSCEIVE 

TYPE^TERMINAL, 

TRMIDNT=7772, 

TBMPRTY*30, 

TRHTYPE-7770, 

TRMSTAT-TRANSCEIVE 

TYPE=TERMINAL, 

TRMIDNT-7773, 

TRMPRTY-30, 

TRMTYPE-7770, 

TBMSTAT-TRANSCEIVE 

TYPE-TERMINAL, 

TRMIDNT-7774, 

TRMPRTY=30, 

TRMTYPE=7770, 

TRMSTAT=TRANSCEIVE, 

USTTRM=POOL 

TYPB*7770MSG, 

MESSAGE* 1 001 DO B« 

TYPE=s7770MSG, 

MESSAGE- 1 00OA0F 1 



2220 AUDIO RESPONSE DNIT UNDER CICS/DOS 



DTF DFHTCT TYPE^SDSCI, 

DEVICE«7770 f 

DSCNAME*DTF7770 # 

SWITCH* YES, 

LINELST* (080,081,082,083) , 

BIKSIZE=256, 

FLNNAME*L17770 
L17770 DFHTCT TYPE-LINE, 

ACCMETH*BTAM, 

TRMTYPE=7770, 

DSCNAME=DTF7770, 



182 



L27770 DFHTCT 



L37770 DFHTCT 



L47770 DFHTCT 



T17770 DFHTCT 



T27770 DFHTCT 



T37770 DFHTCT 



T47770 DFHTCT 



READY 
ERROR 



DFHTCT 
DFHTCT 



INAREAL=256, 

BTAMRLN=1, 

FEATURE=AUTOANSR, 

ANSWRBK=TERMINAL, 

CONVTAB=ABB, 

RDYMSG=READY / 

ERRMSG=ERROR, 

POOLADR=T17770 

TYPE=LINE, 

ACCPIETH=BTAM, 

TRMTYPE=7770, 

DSCNAME=DTF7770, 

INAREAL=256, 

BTAMRLN=2, 

FEATURE=AUTOANSR, 

ANSWRBK=TERMINAL, 

CONVTAB=ABB r 

RDYMSG=READY, 

ERRMSG=ERROR 

TYPE=LINE, 

ACCMETH=BTAM, 

TRMTYPE=7770, 

DSCNAME=DTF7770, 

INAREAL=256, 

BTAMRLN=3, 

FEATURE=AUTOANSR f 

ANSWRBK=TERMINAL, 

CONVTAB=ABB, 

RDYMSG=READY, 

ERRMSG=ERROR 

TYPE=LINE, 

ACCMETH=BTAM, 

TRMTYPE=7770, 

DSCNAME=DTF7770, 

INAREAL=256, 

BTAMRLN=4, 

FEATURE=AUTOANSR, 

ANSWRBK=TERMINAL, 

CONVTAB=ABB, 

RDYMSG=READY, 

ERRMSG=ERROR 

TYPE=TERMINAL, 

TRMIDNT=7771, 

TRMPRTY=30, 

TRMTYPE=7770, 

TRMSTAT=TRANSCEIVE 

TYPE=TERMINAL, 

TRMIDNT=7772, 

TRHPRTY=30, 

TRHTYPE=7770, 

TRMSTAT=TRANSCEIVE 

TYPE=TERMINAL # 

TRMIDNT=7773, 

TRMPRTY=30, 

TRMTYPE=7770, 

TRMSTAT=TRANSCEIVE 

TYPE=TERMINAL, 

TRMIDNT=7774, 

TRMPRTY=30, 

TRMTYPE=7770, 

TRMSTAT=TRANSCEIVE, 

LASTTRM=POOL 

TYPE=7770MSG, 

MESSAGE= , 001D0B' 

TYPE=7770MSG, 



* 
* 
* 
* 
* 

* 
* 
* 
* 
* 
* 
* 

* 

* 

* 

* 

* 
* 

* 

* 
* 

* 

* 
* 

* 
* 

* 
* 
* 

* 
* 

* 
* 
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MESSAGE=»000A0F» 

COMMON C ARRI ER TELETYPEWRITER EXCHANGE TERMINAL (TWX) 

DFHTCT TYPE=SDSCI, * 

CU=2702, * 

DEVICE=TW35, * 

LINELST= (039) , * 

SWITCH=YES, * 
DSCNAME=TWXONE 
IDLTWX DFTRMLST IDLST, , 19, 01B1 51FFC393C3CB052BEB1BB151 E1E1E1E1 A1 
TWXIDA DFTRMLST IDLST, 7 ,4931683, 10, 500AB222C3052B2B9AB1 

DFHTCT TYPE=LINE, * 

ACCMETH=BTAM, * 

TRMTYPE=TWX, * 

DSCNAME=TWXONE, * 

INAREAL=120, * 

BTAMRLN=1, * 

LISTADR=IDLTWX, * 

FEATDRE=(AUTOANSR, AUTOCALL) , * 

POOLADR=TWXAUTO, * 
ANSWSBK=AUTO 

TWXAUTO DFHTCT TYPE=TERMINAL r * 

TRMIDNT=TWXA, * 

TRMADDR=TWXIDA, * 

THMPRTY=201, * 

TRMSTA?=TRANSCEIVE, * 
LASTTRM=POOL 

298 G ENERA L BANKING TERMINAL SYSTEM 

DFHTCT TYPE=SDSCI, * 

CU=2703, * 

DEVICE=BSCMDMPT, * 

BSCODE=EBCDIC, * 

SWITCH=NO, * 
DSCNAME=DTF2980 
TCT29POL DFTRMLST AOTOWLST, (C1C1 F02D, 37373737) POLL CU 
TCT29PA1 DFTRMLST OPENLST, (8181 U02D) ADDRESS STATION 1 
TCT29PA2 DFTRMLST OPENLST, (8 181F12D) ADDRESS STATION 2 
TCT29PA3 DFTRMLST OPENLST, (8181F22D) ADDRESS STATION 3 

DFHTCT TYPE=LINE, * 

ACCMETH=BTAM, * 

TRMTYPE=2980, * 

DSCNAME=DTF2980, * 

INAREAL=480, . . * 

BTAMRLN=1, * 

LISTADR=(TCT29POL,WRAP) , * 
FEATDRE=AUTOPOLL 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=T801, * 

STN2980=0, * 

TAB2980=04, * 

POLLPOS=01, * 

TRMADDR=TCT29PA1, * 

TRMMODL=1, * 

TRMPRTY=10, * 

TIOAL=200, * 
TRMSTAT=TRANSCEIVE 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=T802, * 

STN2980=1, * 

TRMADDR=TCT29PA2, * 
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TRMM0DL=2, 
TRMPRTY=10, 
TIOAL=200, 
TRMSTAT=TRANSCEIVE 
DFHTCT TYPE=TERMINAL, 
TRMIDNT=T803, 
STN2980=2, 
TAB2980=02, 
TRMADDR=TCT29PA3, 
TRMM0DL=4, 
TRMPRTY=10, 
TIOAL=200, 
TRMSTAT=TRANSCEIVE, 
LASTTRM=LINE 



Note: This is a functional example for CICS/DOS if the 
" (C1C1F02D, 37373737) parameters in the above TCT29POL DFTRMLST 
statement are changed to 3732,C1C1F02D. 



3270 INFORMATION DISPLAY SYSTEM 



POLL77 DFTRMLST AUTOWLST, (40407F7F2D,C1 C17F7F2D, 3737373737) 
LSTR77A DFTRMLST OPENLST , (60 6040402D) 
LSTR77B DFTRMLST OPENLST, (61 61 40402D) 
LSTR77C DFTRMLST OPENLST , (61 61C1C12D) 
DFHTCT TYPE=SDSCI, 

DEVICE=BSCMDMPT, 

DSCNAME=REMOTE77, 

BSCODE=EBCDIC 
DFHTCT TYPE=LINE, 

ACCMETH=BTAM, 

TRMTYPE=3277, 

LISTADR=(POLL77,WRAP) , 

BTAMRLN=1, 

DSCNAME=REMOTE77, 

INAREAL=256, 

TRMMODL=2, 

FEATDRE=AUTOPOLL 
DFHTCT TYPE=TERMINAL, 

TRMIDNT=R77A, 

TRMMODL=1, 

TRMTYPE=3275, 

TRMADDR=LSTR77A, 

POLLPOS=1, 

COMPAT= (480,12,2260,2) , 

FEATDRE=PTRADAPT, 

TIOAL=500 
DFHTCT TYPE=TERMINAL, 

TRMIDNT=R77B, 

TRMADDR=LSTR77B, 

POLLPOS=2, 

COMPAT= (960, 15,2265,2) , 

FEATURE=(COPY,DCKYBD,SELCTPEN) , 

TIOAL=1500 
DFHTCT TYPE=TERMINAL, 

TRMIDNT=R77C, 

TRMTYPE=3286, 

FEATURE=COPY, 

TRMADDR=LSTR77C, 

LASTTRM=LINE, 

TRMSTAT=TRANSCEIVE, 

TIOAL=1500 



Note: This is a functional example for CICS/DOS if (1) the (40407F7F2D, 
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C1C17F7F2D, 3737373737) parameters in the above POLL77 DFTRMLIST 
• statement are changed to 3732,40407F7F2D, C1C17F7F2D, and (2) 
J the LINELST= (029) and CU=2703 operands are included in the DFHTCT 

TYPE=SDSCI specification. 

2780 DATA TRANSMISSION TERMINAL 

DFHTCT TYPE=SDSCI, * 

BSCODE=EBCDIC, * 

DDNAME=DDN2780, * 

DEVICE=2780, * 

DSCNAME=DCBN2780, * 

I CU=2703, * 

LINELST=(0 23) , * 

FEATURE=(BSC,SLV) , * 

MODELST=0, * 

CONFIG=PPT, * 

SWITCH=NO, * 

DSORG=CX, * 

MACRF=(R,H), * 
DEVD-BS 

DFHTCT TYPE=LINE, * 

TRMTYPE=2780, * 

DSCNAME=DCBN2780, * 

ACCMETH=BTAM, * 

BTAMRLN=1, * 

BSCODE=EBCDIC, * 
INAREAL=520 

N2780 DFHTCT TYPE=TERMINAL, * 

TRMIDNT=T80A, * 

LASTTRM=LINE, * 

TRMTYPE=2780, * 

TIOAL=100, * 

TRMSTAT=TRANSCEIVE, * 
TRMPRTY=126 

277 DATA COMMUNICATION SYSTEM 

DFHTCT TYPE=SDSCI / * 

BSCODE=EBCDIC, * 

DDNAME=DDD2770, * 

DEVICE=2770, * 

DSCNAME=DCBD2770, * 

DSORG=CX, * 

MACRF=(R,W), * 

, CU=2703, * 

LINELST=(020) , * 

1 FBATURE=(BSC,SLV) , * 

MODELST=0, * 

CONFIG=PPT, * 

SWITCH=YES, * 
DEVD=BS 

DFHTCT TYPE=LINE, * 

TRMTYPE=2770, * 

DSCNAME=DCBD2770, * 

ACCMETH=BTAM, * 

BTAMRLN=1, * 

BSCODE=EBCDIC r * 

POOLADR=D2770, * 

INAREAL=520, * 

FEATURE=AUTOANSR, * 

LISTADR=LA2770, * 
ANSWRBK=TERMINAL 
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D2770 DFHTCT TYPE=TERMINAL, * 

TRMIDNT=D70A, * 

LASTTRM=POOL, * 

TIOAL=100, * 

TRMTYPE=2770, * 

TRMADDR=TA2770, * 

TRMSTAT=TRANSCEIVE, * 
TRMPRTY=126 

LA2770 DFTRMLST BSCLST,0 , 1 ,2D, 2, 1070 

TA2770 DFTRMLST BSCLST,0 , 2, 1070 , 1 ,2D 

SYSTEM/3 

DFHTCT TYPE=SDSCI, * 

BSCODE=EBCDIC, * 

DDNAME=DDDSYS3, * 

DEVICE=SYS/3, * 

DSCNAME=DCBDSYS3, * 

DSORG=CX r * 

MACRF=(R r W) r * 

CU=2703, * 

LINELST=(020) , * 

FEATURE=(BSC,SLV) , * 

MODELST=0, * 

CONFIG=PPT, * 

SWITCH=YES, * 

DEVD=BS, * 

DFHTCT TYPE=LINE, * 

TRMTYPE=SYS/3 r * 

DSCNAME=DCBDSYS3, * 

ACCMETH=BTAM r * 

BTAMRLN=1 # * 

BSCODE=EBCDIC, * 

POOLADR=SYS3D, * 

INAREAL=500, 96 X 5 + 20 PAD * 

FEATURE=AUTOANSR, * 

LISTADR=LASYS3, * 
ANS»RBK=TERMINAL 

SYS3D DFHTCT TYPE=TERMINAL, * 

TRMIDNT=DSY3, * 

LASTTRM=POOL, * 

TIOAL=100, * 

TRMTYPE=SYS/3, * 

TRMADDR=TASYS3, * 

TRMSTAT=TRANSCEIVE, * 
TRMPRTY=126 

LASYS3 DFTRMLST BSCLST, 0, 1 ,2D, 2, 1070 

TASYS3 DFTRMLST BSCLST,0 , 2, 1070, 1 , 2D 

3735 PROGRAMMABLE BUFFERED TERMINAL (Not applicable to CICS/DOS- Entry) 

DFHTCT TYPE=SDSCI, * 

DEVICE=BSCMDSW, * 

CU=2703, * 

BSCODE=EBCDIC, * 
DSCNAME=DTF35D 

DFHTCT TYPE=LINE, * 

ACCMETH=BTAM, * 

TRMTYPE=3735, * 

DSCNAME=DTF35D, * 

INAREAL=480, * 

BTAMRLN=1, * 

LISTADR=LISTA, * 

187 



FEATURE= (AUTOANSR, AUTOCALL) , * 

POOLADR=A3735, * 

BSCODE=EBCDIC, * 
ANSWRBK=EXIDVER 

A3735 DFHTC TYPE=TERMINAL, * 

TRMIDNT=3735, * 

TRMTYPE=3735, * 

LASTTRM=POOL, * 

TRMADDR=LISTB, * 

TRMSTAT=TRANSCEIVE, * 

TRANSID=3735, * 
TI0AL=476 
LISTA DFTRMLST SWLST, AN, 1 1 ,4, 2, 1 070, (98F0F3F5 182D, , A3735) 
LISTB DFTRMLST SWLST, AD r 4,337*1, 8, 0, 1 ,2D, (98F0F3F5181070, 1) 

2540 CARD READ PUNCH/1403 PRINTER 

DFHTCT TYPE=SDSCI, * 

DEVADDR=SYSIPT, * 

DEVICE=2540, * 
DSCNAME=READER 

DFHTCT TYPE=SDSCI, * 

DEVADDR=SYSLST, * 

DEVICE=1403, * 
DSCNAME=PRINTER 

DFHTCT TYPE=LINE, * 

ACCMETH=BSAM, * 

TRMTYPE=CRLP, * 

ISADSCN=READER, * 

OSADSCN=PRINTER, * 
INAREAL=80 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=SAMA, * 

TRMTYPE=CRLP, * 
TRMSTAT=TRANSCEIVE 

2314 DIRECT ACCESS STORAGE FACILITY 

DFHTCT TYPE=SDSCI, * 

DEVADDR=SYS001, * 

DEVICE=2314, * 
DSCNAME=DISKIN1 

DFHTCT TYPE=SDSCI, * 

DEVADDR=SYS006, * 

DEVICE=2314, * 
DSCNAME=DISK0T1 

DFHTCT TYPE=LINE, * 

ACCMETH=SEQUENTIAL, * 

TRMTYPE=DASD, * 

ISADSCN=DISKIN1, * 

0SADSCN=DISK0T1, * 
INAREAL=80 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=SAMB, * 

TRMPRTY=11, * 
TRMSTAT= (TRANSCEIVER OUT OF SERVICE') 

2260 DISPLAY STATION (LOCAL) 

DFHTCT TYPE=SDSCI, * 

CU=2848, * 

DEVICE=L2260, * 
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LINELST=(021,022,023) , * 

FEATURE=KBL, * 

SWITCH=NO, * 

FLNNAME=LINE1, * 
DSCNAME=DTF60L 

LINE1 DFHTCT TYPE=LINE, * 

ACCMETH=BTAM, ACCMETH=BGAM FOR CICS/OS * 

TRMTYPE=L2260, * 

CLASS=VIDEO, * 

DSCNAME=DTF60L r * 

INAREAL=960, * 
FEATURE=KBRDLOCK 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=L60A, * 

LVUNIT=1, * 

TRMPRTY=32, * 
TRMSTAT=TRANSCEIVE 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=L60B, * 

LVUNIT=2, * 

TRMPRTY=32, * 
TRMSTAT=TRANSCEIVE 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=L530, * 

TRMTYPE=1053, * 

LVUNIT=3, * 

TRMPRTY=32, * 

TRMSTAT=RECEIVE, * 
LASTTRM=LINE 

3270 INFORaATION DISPLAY SYSTEM (LOCAL) 

DFHTCT TYPE=SDSCI, * 

DEVICE=L3277, * 
DSCNAME=L3270 

DFHTCT TYPE=LINE, * 

ACCMETH=3TAM, * 

DSCNAME=L3270, * 

TRMMODL=2, * 

TRMTYPE=L3277, * 

POOLADR=T010, * 

INAREAL=2500, * 
POOLCNT=2 

T010 DFHTCT TYPE=TERMINAL, * 

TRMIDNT=L77A, * 

LVUNIT=1, * 

FEATURE=(SELCTPEN,AUDALARM) , * 
COMPAT= (480, 12,2260,2) 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=L77B, * 

LVUNIT=2, * 

TRMTYPE=L3277, * 

LASTTRM=POOL, * 
TRMSTAT=TRANSCEIVE 

Note: This is a functional example for CICS/DOS if (1) the CU=3272 
and LINELST= (030,031) operands are included in the DFHTCT 
TYPE=SDSCI specification, and (2) if the POOLCNT=2 operand is 
deleted from the DFHTCT TYPE=LINE specification. 
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APPENDIX C: CICS/TCAM PROGRAM INTERRELATIONSHIP 



The following illustrates the interrelationship between the TCAM 
Message Control program (MCP) and the TCAM Message Processing prograi 
(MPP) . CICS is regarded as a Message Processing program by TCAM. 



TCAM MCP 



CICS MPP 



2260 REMOTE: 




2260 LOCALS 
TRM2 





DD CARDS 


//QINI 


DD 


QNAME-RISI 


//QOUTI 


DD 


QNAME-WISI 


//R2260IN DD 


QNAME=R60I 


//R2260UT DD 


GNAME=R600 



TOCICS 
MESSAGc 
HANDLER 



R600 
TPROCESS 



RISI 
TPROCESS 



READ 



WISI 

TPROCESS 



ISDSCKDCB ) 



TCTLE 
DDNAME 
nir .B2260IN [~ 




S65A 



TCTLE 
DDNAME 

0UTQ- QINI H 



SBW 



WHITE 




TCTTE 



TRM2 



TRM1 
TCTTE 



The following is an example of a CICS Terminal Control Table and a 
TCAM Message Control program. 



CICS TERMINAL CONTROL TABLE 



DFHTCT TYPE=INITIAL,SUFFIX=TV 
DFHTCT TYPE=SDSCI, 

DEVICE=TCAM, 

DSCNAME=L1, 

DDNAME=QIN1, 

OPTCD=WU # 

MACRF=R r 

RECFM=0, 

BLKSIZE=500 
DFHTCT TYPE=SDSCI, 

DEVICE=TCAM, 

DSCNAME=L2, 

DDNAME=QOOT1, 

OPTCD=WU, 

MACRF=W, . 

RECFM=U r 
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DFHTCT 



DFHTCT 



OUTQ DFHTCT 



DFHTCT 



DFHTCT 



DFHTCT 



DFHTCT 



DFHTCT 



DFHTCT 



OUTQ60 DFHTCT 



DFHTCT 



DFHTCT 



DFHTCT 



BLKSIZE=500 

TYPE=LINE, 

ACCHETH=TCAM, 

QUE0EID=F1, 

INAREAL=500, 

TRMTYPE=L2260, 

DSCNAME=L1, 

OUTQ=OUTQ 

TYPE=TERMINAL, 

TRMIDNT=DMMY, 

TRMPRTY=32, 

LASTTRM=LINE 

TYPE=LINE, 

ACCMETH=TCAM, 

QUEUEID=FO, 

INAREAL=500, 

TRMTYPE=L2260, 

DSCNAME=L2 

TYPE=TERMINAL, 

TRMIDNT=TRM1, 

TRMPRTY=32 

TYPE=TERHINAL, 

TRHIDNT=TRM2, 

LASTTRM=LINE, 

TRMPRTY=32 

TYPE=SDSCI, 

DEVICE=TCAM, 

DSCNAME=R60IN, 

DDNAME=R2260IN, 

OPTCD=WU, 

MACRF=R, 

RECFM=U, 

BLKSIZE=500 

TYPE=SDSCI, 

DEVICE=TCAM, 

DSCNAME=R60OUT, 

DDNAME=R2260OUT, 

OPTCD=WU, 

HACRF=W, 

RECFM=U, 

BLKSIZE=500 

TYPE=LINE, 

ACCMETH=TCAM, 

INAREAL=500, 

DSNAME=R60IN, 

OUTQ=OUTQ60 r 

TRMTYPE=2260 

TYPE=TERMINAL, 

TRMIDNT=1260, 

TRMPRTY=32, 

LASTTRM=LINE 

TYPE=LINE, 

ACCMETH=TCAM, 

INAREAL=500, 

DSCNAME=R60OUT, 

TRMTYPE=2260 

TYPE=TERMINAL, 

TRMPRTY=32, 

TRMIDNT=S60A 

TYPE=TERMTNAL, 

TRMPRTY=32, 

TRMIDNT=S60B 

TYPE=TERMINAL, 

TRMPRTY=32, 

TRMIDNT=S65A, 



* 
* 

* 

* 
* 
* 

* 

* 

* 
* 

* 

* 
* 

* 

* 

* 

* 
* 
* 

* 
* 
* 
* 
* 

* 
* 
* 

* 

* 
* 

* 

* 
* 

* 
* 
* 
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LASTTRM=LINE 
DFHTCT TYPE=FINAL 
END DFHTCTBA 



TCAM MESSAGE CONTROL PROGRAM 



MCPCICS 


CSECT 




TCAMINIT 


INTRO 


DISK=NO, 

PROGID=TCAM/CICS, 

LNUNITS=40, 

MSUNITS=20, 

KEYLEN=133, 

CROSSRF=4, 

DLQ=TRM1, 

STARTUP=CY, 

TRACE=10, 

LINETYP=BOTH, 

OLTEST=0 




LTR 


15,15 




BZ 


OPENLINE 


NOEXEC 


ABEND 


123, DUMP 


OPENLINE 


OPEN 


(LG2260, (INOUT) ,PG2260, (INOUT)) 




TM 


LG2260+4 8,DCBOFLGS 




BNO 


NOEXEC 




TM 


PG2260+48,DCBOFLGS 




BNO 


NOEXEC 




WTO 


'TIME TO START APPLICATION PROGRAM' 



FINISH 



LG2260 



PG2260 



QPROC 



RIS1 

WIS1 
R60I 
R600 
S60A 

S60B 

S65A 

TRM1 



READY 

CLOSE (LG2260,,PG2260) 

L 13,U(13) 

RETURN (1U,12) 

DCB DSORG=TX, 

MACRF=(G,P) , 
CPRI=S, 

DDNAME=DDLG2260, 
MH=TOTCAM, 
PCI=(N,N), 
BUFSIZE=464, 

INVLIST= (POLLST1, , , POLLST2) ,TRANS=EBCD 
DCB DSORG=TX,MACRF= (G,P) , CPRI=S, DDNAME=DDPG2260 , 
MH=MH2260,PCI=(N,N) , BUFSIZE=464, 
INVLIST=(POLL60R,,) ,TRANS=2260 
PCB MH=TOCICS, 

BULSIZE=464, 
RESERVE=(20) 
TTABLE LAST=TRM2 
TPROCESS PCB=QPROC 
QOEUES=MO 
v .,, TPROCESS PCB=QPROC 
- ^PROCESS PCB=QPROC,QUEUES=MO 
-/TPROCESS PCB=QPROC 
^TERMINAL QBY=T,DCB=PG2260,RLN=1, TERM=226R,QUEUES=MO, 

ADDR=40A0EOFF 
* TERMINAL QBY=T,DCB=PG2260, RLN=1 , TERM=226R , QUEUES=MO, 
ADDR=40A1EOFF 
TERMINAL QBY=T,DCB=PG2260,RLN=1, TERM=2265, QUEUES=MO, 

^,.ADDR=4151E0FF 
TERMIN#L*T|BY=L, 

ih D,CB=LG2260, 

"^ERM=226L r 
QUEUES=MO, 
ADDR=FFFFFFFF r 
SECTERM=YES 
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TRM2 



P0LLST1 
P0LLST2 

POLL60R 
TOTCAM 



INMSG 



MH2260 



TOCICS 



DCBOF1GS 



TERMINAL QBY=L, 

DCB=LG2260, 

RLN=2, 

TERM=226L f 

ADDR=FFFFFFFF, 

QUEUES=MO 
INVLIST ORDER=(TRM1 + 02) 
INVLIST ORDER= (TRM2+02) 

INVLIST ORDER= (S6 0A+4 0A040, S60B+40A1 40, S6 5A+ 41 51 40) 
STARTMH LC=OUT 
INHDR 
CODE 
FORWARD 
EQU 
INMSG 
INEND 
OUTHDR 
OUTEND 
STARTMH 
INHDR 
CODE 
SETSCAN 
MSGEDIT 
FORWARD 
INMSG 
INEND 
OUTHDR 
SETSCAN 
MSGEDIT 
MSGFORM 
CODE 
OUTEND 
STARTMH 
INHDR 
CODE 
FORWARD 
INEND 
OUTHDR 
OUTEND 
EQU 
END 



DEST=C«RISl f 
* 



LC=OUT 



((R,,SCAN)) 

DEST=C , R60I» 



((R, ,SCAN)) 

BLOCK=460 



LC=OUT 



DEST=PUT 



XM0» 
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APPENDIX D: TERMINAL CONTROL TABLE CONFIGURATOR 



This section is intended to aid the system programmer in the 
preparation of the Terminal Control Table (TCT) as he uses operands of 
the DFHTCT macro instruction to: 

1 . Specify data set control information 

2. Describe communication lines 

3. Describe terminal types 

Included in this section is an indication of whether the operands of 
the DFHTCT macro instruction are: 

1. Optional or required 

2. Applicable only to CICS/DOS, only to CICS/OS, or to both CICS/DOS 
and CICS/OS 

3. Applicable or required only under special circumstances 
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SPECIFY DATA SET CONTROL INFORMATION 
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Note : R Required. 
O Optional. 

* CICS/DOS only, 
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# CICS/OS only. 



DESCRIBE COMMUNICATION LINES 
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Note: 



R Required, 
O Optional. 



# CICS/OS only. 

* TRMMODL may be specified in TYPE=LINE or TYPE=TERMINAL. 

Required if a terminal work area (PCI) field is to be 
defined for all terminal entries associated with this line. 

1 Specify ACCMETH=SAM, ACCMETH=BSAM, or ACCMETH=SEQOENTIAL. 

2 Specify ACCMETH=BGAM or ACCMETH=GRAPHICS. 

3 Specify ACCMETH=BTAM or ACCMETH=TELECOMMONICATION. 

4 Required for switched (dial-up) lines and multipoint lines. 

5 Required if FEATURE=(AUTOANSR, AUTOCALL, SCONTROL) . 

6 Required for first line in switched-line pool; specify 
ANSWRBK=EXIDVER for 3735 under CICS/OS and CICS/DOS-STANDARD 
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7 Checking required; other features optional. 

8 Required for component polling; default: poll all components, 

9 Required for the 2740 Model 2 or the 2740 with 2760. 



DESCRIBE TERMINAL TYPES 



TRMTYPE 


T 
R 
M 
I 
D 
N 
T 


T 
R 
M 
P 
R 
T 
Y 


T 
R 
M 
M 

D 
L 


c 

L 
A 
S 
S 


L 
V 
D 

N 

I 
T 


L 
A 
S 

T 
T 
R 
M 


T 
R 
M 
A 
D 
D 
R 


T 
R 
M 
S 
T 
A 
T 


c 



M 

p 

A 
T 


F 
E 
A 
T 

R 
E 


p 


L 
L 
P 
O 

s 


T 
R 
A 
H 

S 

I 
D 


s 

T 
N 
2 
9 
8 



T 
A 
B 
2 
9 
8 


T 
I 
O 
A 
L 


T 

c 

T 
U 
A 
L 


1030 


R 


O 


O 







O 


R3 


O 








R 








R7 


1050 


R 





RS 


O 




O 


R3 




















R7 


1053 OS 


R 








O 


R* 





R2 




















R* 


1053 DOS 


R 





O 


O 


R* 





R2 




















R7 


1130 


R 
















R* 






















R7 


2020 


R 
















R* 






















R7 


2260 


R 
















R3 



















O 


R7 


L2260 


R 











R 

























R7 


2265 


R 
















R3 




















R* 


2740 


R 





R* 










R3 




















R7 


2740/2760 


R 





R 










R3 











R 








R* 


2741C 


R 





O 






























R7 


2741E 


R 



























O 








R* 


2770 


R 
















R* 






















R7 


2780 


R 
















R* 






















R7 


2980 


R 





R 










R 









R 





R 


R 





R7 


3275 


R 





R 










R 











R 












R* 


3277 


R 





R 










R 











R 












R* 


L3277 


R 





R 





R 



























R* 


3284 


R 





R 










R 











R 












R7 


L3284 


R 





R 





R 



























R* 


3286 


R 





R 










R 











R 












R7 


L3286 


R 





R 





R 



























R* 


3735 


R 















R* 











R 








R* 


7770 


R 




































R* 


SYS/3 


R 

























O 












R* 


SYS/7 


R 
















R3 




















R7 


S360 


R 
















R* 






















R* 


CRLP 


R 




































R* 


DASD 


R 




































R* 


TAPE 


R 




































R* 


TWX 


R 
















R3 




















R7 


U/R 


R 











,„. „. 

























R7 



Note: R Required. 
Optional. 



1 Required only for local devices. 

2 Required only for remote devices; specify hexadecimal 
addressing characters. 

3 Required; specify hexadecimal addressing characters for 
non-switched lines; specify name of DFTRMLST for switched 
lines. (For TWX, not required if ANSWRBK=TERMINAL is 
specified) • 

4 Required for multipoint lines and for switched lines if 
FEATURE=AUTOCALL has been specified in the 

DFHTCT TYPE=LINE macro instruction; specify name of DFTRMLST. 

5 Required for component polling; defaults to polling all 
components. 
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6 Required for the 2740 Model 2 or the 2740 with 2760. 

7 Required for terminals when the user defines a 0-255 

byte terminal work area (Process Control Information field) . 
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APPENDI X E: FILE CONTROL TABLE CONF IGUR ATOR 



This section is intended to aid the system programmer in the 
preparation of the File Control Table (FCT) as he uses the DFHFCT 
TYPE=DATASET macro instruction to describe the physical characteristics 
of the data sets. These descriptions include information about the 
access method (BDAM or ISAM) and record characteristics for the data 
sets. 
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SERVREQ=KEY 
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R 





Note : R Required. 

Optional. 

1 Specifies relative type addressing; RELTYPE must also be 
specified. 

2 Required if main storage high-level index processing is 
used. 

3 Required if INDAREA is specified. 

4 Required only if a master index exists. 

5 Optional; used only if SERVREQ=NEWREC; for ISAM data sets 
under CICS/OS, IOWORK should also be specified. 

6 If SERVREQ=BROWSE or SERVREQ=NEWREC, this value must be 
BLKSIZE plus BLKKEYL. 

7 Required if key exists within logical records. 

8 Required if deblocking by key for BDAM (CICS/DOS and 
CICS/OS) ; required for variable-length ISAM records in 
fixed-length blocks (CICS/DOS only) . 
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APPENDIX F: CICS MACRO INSTRUCTIONS 



This section lists the CICS macro instructions used for system 
generation and table preparation. These macro instructions are written 
in Assembler language and, as all Assembler language instructions, are 
written in the following format: 

lame Operation Operands C omments 

blank DFHxxxxx One or more operands 

or separated by commas 

symbol 

The name field of a CICS macro instruction must be left blank if 
the macro instruction is used in conjunction with a high-level language 
(ANS COBOL or PL/I) ; if a label is desired for the macro instruction, 
it may be placed on the card preceding the macro instruction. 

The operation field of a CICS macro instruction must begin before 
card column 16 and must contain the three-character combination "DFH" 
in the first three positions of the operation field. Up to five 
additional characters can be appended to DFH to complete the symbolic 
name for the appropriate program or table. Since DFH is reserved for 
CICS macro instructions, no other statement may begin with this 
three-character combination. 

The operand field of a CICS macro instruction contains one or more 
operands separated by commas. In this publication, parentheses are 
used to indicate those operands where more than one applicable parameter 
(keyword and otherwise) can be specified with a single use of the 
operand. Where parentheses are not used, only one parameter at a time 
can be specified as part of the operand; a choice must be made in the 
case of more than one applicable parameter. Since a blank character 
indicates the end of the operand field, the operand field must not 
contain blanks except after a comma on a continued card or after the 
last operand of the macro instruction. The first operand on a 
continuation card must begin in column 16. 

When a CICS macro instruction is coded on more than one card, each 
card containing part of the macro instruction (except the last card) 
must contain a character (for example, an asterisk) in column 72 
indicating that the macro instruction has been continued oh the next 
card. 

In the following listing of CICS macro instructions, default 
parameters (where applicable) are indicated by an underscore. An 
asterisk in card column 72 indicates that the macro instruction is 
continued on the next card. 

Because the flexibility and modularity of CICS allows a wide 
combination of options during system generation and table preparation, 
no attempt is made in this section to indicate which operands are 
optional and which are mandatory. For this information, refer to the 
previous sections of this publication. 
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INITIALIZATION OF SYSTEM GENERATION 

DFHSG TYPE=INITIAL, * 

STATUS=FIRST, * 

ASMBLR=Asserabler name, * 

OPSYS= (VS1,VS2, number) , * 

TRACE=YES,NO, * 

TIMECTL=YES,NO, * 

DSIZE=number,2, * 

MPS=YES,NO, * 

JOBNAME=jobnarae,CICS, * 

ACCTID=accounting information, CJ^GEN, * 

PGMERID=« programmer's name 1 . 'SYSTEM PROGRAMMER' , * 

MSGLVL=0,1, * 

DEVICE=2311, 2314, 3330, * 

CONDCD= ( (code, operator) , . . . , (code, operator) ) , * 

PRIORTY=nn, * 

MSGCLAS=X,A, * 

CLASS= jobclass, A, * 

REGION= (nlK,n2K) , * 

PROCNMS=procedure names, (pFHASMy2,DFHLNKV2, * 

PFHUPDV2,DFHAUPLK) , * 

DL1=YES,N0, "* * 

ATP=YES,NO, * 

PREFIX=prefix, * 
TCTUA= (V1CMPAT, VARIABLI) 

CONTROL SYSTEM OP ERA TIONAL GROUP (CSO) 

DFHSG PROGRAM=CSO, * 

MPS=YES,NO, * 

NSD=number,9, * 

DEVICE= 231.1, 231 4, 3330, * 

SVC= number 7200, * 

CAA=appendage suffix, * 

V1CMPAT=YES, * 
TCAMSIP=YES 

CONTROL SYSTEM SERVICE GROUP (CSS) 
DFHSG PROGRAM=CSS 

CONTROL SYSTEM DUMMY GROUP (CSD) 
DFHSG PROGRAM=CSD 

CONTROL SYSTEM UTILITY GROUP (CSU) 

DFHSG PROGRAM=CSU, * 
DEVICE= (TAPE., 2 31 1,2314, 3330) 

TASK CONTROL PROGRAM (KCP) 

DFHSG PROGRAM=KCP, * 

CONSEC=YES, *. 

RUNAWAY=YES, * 

STALCTL=YES, * 

ENQUEUE=YES, * 

- OPSECUR=YES, * 

ICPTIME=YES, * 
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ICPAUTO=YES, * 

ICPSYNC=YES, * 

SUFFIX=program suffix, * 

XTYPREQ=symbolic name, * 

XDSPCHS=symbolic name, * 
DEVICE= (2311,2314,3330) 

STORAGE CONTROL PROGRAM (SCP) 

DFHSG PROGRAM=SCP, * 

XTYPREQ=syrabolic name, * 
SUFFIX=program suffix 

PROGRAM CONTROL PR OGRAM (PCP) 

DFHSG PROGRAM=PCP, * 

PCPLOAD=YES,NO, * 

LANG= (COBOL, PL/I) , * 

HLLTR=YES,NO, * 

COBOL= (V2,V3,V4, SUBSET) , * 

XFETCH=symbolic name, * 
SUFFIX= pro gram suffix 

PROGRAM INTERRUPT CONTROL PROGRAM (PIP) 

DFHSG PROGRAM=PIP, * 
SUFFlX=program suffix 

INTERVAL CONT ROL PROGRAM (ICP) 

DFHSG PROGRAM=ICP, * 

RUNAWAY=YES, * 

-ICPTIME=YES, * 

ICPA0TO=YES, * 

ICPSYNC=YES, * 

SUFFlX=program suffix, * 

XTYPREQ=symbolic name, * 

XICEEXP=symbolic name, * 
DUMMY=YES 

DUMP CONTROL PROGRAM (DCP) 

DFHSG PROGRAM=DCP, * 

DEVICE=TAPE, 2311, 2314, 3330, * 

DEVADDR=nnn, * 

CICSDMP=YES, * 

SUFFIX=program suffix, * 
DUMMY=YES 

TERMINAL CONTROL PROGRAM (TCP) 

DFHSG PROGRAM=TCP, * 

ACCMETH=(BTAM,BSAM,SAM,BGAM,TCAM) , * 

DEVICE= (1403, 14 04, 1442, 1443, 1445, 231 1,231 4, 3330, * 

2501, 2520, 2540, CRLP,DASD, DISK, TAPE) , * 

BTAMDEV= (1030,1 050, 1050D, 1053, 1130, 11 30 D, 2020, 2020D, * 

2260, L2260, 2265, 2740, 2740D, 2740-2, 2741C,2741E, * 

2741DC,2741DE,2760, 2770, 2770D, 2780, 2780D, * 

2980/1, 2980/2, 2980/4, 3275, 3277, L3277, 3284, * 
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L3284,3286,L3286,3735D, 7770, SYS/3 ,SYS/3D, SYS/7, * 

SYS/7D,S/360,S/360D, S/370,S/370D,TWX,BISYNC) , * 

FEATURE=(AUTOANSW,AUTOPOLL,BUFFRECV,PSEUDOBIN) , * 
ANSWRBK= (EXIDVER, TERMINAL, AUTOMATIC, 7770TERM,7770NULL) , '* 

INITRL=YES, * 

LOCKF=YES, * 

WRAPLST=YES, * 

BSCODE= (EBCDIC, ASCII, TRANSCODE) , * 

AUTOTRN-YES, ~ * 

UCTRAN=NO, (EBCDIC, ASCII) , * 

COMPAT=NO, (FORMAT, FULLBOF) , * 

FMT2260= (6X40, 12X40,12X80,15X64) , * 

FMT327Q= (12X40,24X80) , * 

SMI=user character, £, * 

TAB=YES,NO, ~ * 

CONVTAB=(ABB,ABC) , * 

XATTACH=symbolic name, * 

XOOTPOT=symbolic name, * 

XINPUT=symbolic name, * 

XTCMIN=symbolic name, * 

XTCMOUT=symbolic name, * 

TCH3270=YES, * 

TCM7770=YES, * 

BMS=YES,NO, * 
SUFFIX=program suffix 

FILE CON TROL PROGRAM (FCP) 

DFHSG PROGRAM=FCP, * 

CONSEC=YES, * 

FILSERV=(INDA,INIS,DADPD,ISOPD,DAADD,ISADD,INDIRACC, * 

EXCTL,INSEG,OUTSEG,DABLKNG,VLR, HEXAD,DECAD, * 

ACTAD,IVBR, LOCATE, IBROWSE, DBROWSE) r * 

SOFFIX=program suffix, * 

XTYPREQ=symbolic name, * 

XOUTPUT=symbolic name, * 

XINPUT=symbolic name, * 

XINPUTC=symbolic name, * 
DUMMY=YES 

TRANSIENT DAT A CONTROL PROGRAM (TDP) 

DFHSG PROGRAM=TDP, * 

INTRA=YES,TRANSINIT, * 

EXTRA= (ACQUISITION, DISPOSITION) , * 

SUFFIX=program suffix, * 

DEVICE=231I, 231 4,3330, * 

XTYPREQ=symbolic name, * 

XOUTPUT=symbolic name, * 

XINPUT=symbolic name, * 
DUMMY=YES 

TEMPORARY STORAGE CONTROL PROGR AM (TSP) 

DFHSG PROGRAM=TSP, * 

DEVICE=231 1,2314.3330, * 

VIRTUAL= (VIRTUAL, REAL) , * 

SUFFIX= pro gram suffix, * 

XTYPREQ=symbolic name, * 

XOUTPUT=symbolic name, * 

XINPUT=symbolic name, * 
DUMMY=YES 
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COMMON SYSTEM AREA (CSA) 

DFHSG PROGRAM=CSA, * 

WRKAREA=number,,512, * 

SUFFIX=program suffix 

MASTER TERMINAL PROGRAM (MTP) 

DFHSG PROGRAM=MTP, * 

TLT=YES,NO 

DYNAMIC OPEN/CLOSE PROGRAM (OCP) 
DFHSG PROGRAM=OCP 

GRAPHIC ATTENTION PROGRAM (GAP) 
DFHSG PROGRAM=GAP 

HIGH-LEVEL LANGUAGE SUPPORT GROUP (HLL) 

DFHSG PROGRAM=HLL, * 

LANG= (COBOL, PL/I) , * 

PL1=(0,F) 

TERMINAL DEPENDENT CONTROL PROGRAM (TDCP) 
DFHSG PROGRAM=DDM 

ASYNCHRONOUS TRANSACTION PROCESSING GROUP (ATP) 

DFHSG PROGRAM=ATP, * 

INBUFF=number, * 

OUTBUFF=number 

TERMINATION OF CICS/DOS SYSTEM GENERATION 
DFHSG TYPE=FINAL 
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SYSTEM INITIALIZ ATIO N TABLE (SIT) 

DFHSIT TYPE=CSECT,DSECT, * 

SUFFIX=xx, * 

TRT=decimal value, 0, * 

SCS=decimal value. 500, * 

SP1=decimal value, 0, * 

DVT=2311, 2314, 3330, * 

MSGLVL=0,I, * 

TSBLK=decimal value, 3625, * 

ICV=decimal value, 1000, * 

ICVS=decimal value, 20000, * 

ICVE=decimal value. 5000. * 

CDL=decimal value, 5, * 

MXT=decimal value, 5, * 

TCT=xx, * 

PPT=xx, * 

PCT=xx, * 

FCT=xx,NO, * 

DCT=XX,NO, * 

CSA=xx, * 

KCP=xx, * 

SCP=xx, * 

PCP=xx, * 

DCP=xx,NO, * 

ICP=xx,NO, * 

TCP=xx, * 

FCP=xx, * 

TDP=xx, * 

TEP=xx,N0, * 

PIP=xx,N0, * 

TSP=xx,NO, * 

OSCOR=decimal value, 0, * 

PL1=YES,NO, * 

DL1=YES,NO, * 

PSB=name,CICSPSB, * 

PSBPL=number,4, * 

DMBPL=number,4, * 

BUFPL=number,8, * 

ATP=YES,NO, "" * 

ATPMT=number,l * 

ATPMB=number,MXT speci fica tion minus one, * 
SIMODS=(A2,Bj,CjL,C2,C3,Dl,El)~or 

(A2,bi,ci,dT,ej.)~ 
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TERMINAL CONTROL TABLE (TCT) 

DFHTCT TYPE=INITIAL, * 
SUFFIX=XX 

DFHTCT TYPE=SDSCI, * 

DEVADDR=SYSnnn, * 

DEVICE=1030, 1050, 1130,1403,140 4, 1442, 1443, 1445, * 

2020, 2260, L2260, 2265, 2311, 2314, 2501, 2520, * 

2540,2740,2740/2760, 274 1C,2741E, 2770, 2780, * 

2980, 3275, 3277, L3277, 3284, L3284, 3286, L3286, * 
3330,3735,7770, BSCMDMPT,BSCMDPPT,BSCMDSW, DA SD, * 

DISK, SYS/3, SYS/7, S3 60, TAPE ,TW33 ,TW35,TCAM, * 

DSCNAME=name, * 

ERROPT=E,R,W,C,N,RW,T, * 

FEATURE=(STC,CHK,BSC,KBL,OIU,SIX,SXW,SIW,RIX, * 

RXW,RIW,MAS,SLV,APL) , * 

LINELST=(nnn1,.. .,nnn31) , * 

SWITCH=YES,NO, * 

CU=2701, 2702,2703, 2848, 3272, * 

CONFIG=PPT,MPT, * 

BSCODE= EBCDIC., ASCII, TRANSCODE, * 

MODELST=(n1,.. .,n31) , * 

RETRY=number,7, * 

TERMTST=YES,NO, * 

LERBADR=symbolic address, * 

DDNAME=name, defaults to DSCNAME, * 

MACRF=(R,W), " * 

FLNNAME=name, * 

NCP=number,.1, * 

MODE=(,CNTRL,A or B,A or B) , * 

BLKSIZE=length, ~* * 

RECFM=F,V,U, * 

SYNAD=symbolic name, * 

OPTCD=W,WU,WC,WUC, * 
APPENDG=appendage suffix 

symbol DFHTCT TYPE=LINE, * 

ACCMETH=SAM,BSAM,BTAM,BGAM,TCAM, SEQUENTIAL, GRAPHIC, * 

TELECOMMUNICATION, * 

TRMTYPE=1 030, 1050, 1053, 11 30, 2020, 2260, L2260, 2265, * 

2740, 2740/2760, 2741C,2741E, 2770, 2780, 2980, * 
3275, 3277, L3277, 3284, L3284, 3286, L3286, 3735, 7770, * 

SYS/3, SYS/7, S360,CRLP,DASD, TAPE, TWX,U/R, * 

CLASS= (CONV, BATCH, VIDEO, HARDCOPY,BISYNC, AUDIO) , * 

DSCNAME=name, * 

ISADSCN=name, * 

OSADSCN=name, * 

INAREAL=length, * 

TRMMODL=number or character, * 

BTAMRLN=number, * 

LISTADR= (name, WRAP) , * 

FEATURE= (AUTOANSR, AUTOCALL, AUTOPOLL, CHECKING, * 

SCONTROL,BUFFRECV,KBRDLOCK) , * 

NPDELAY=number, * 

POOLADR=symbolic address, * 

ANSWRBK=AUTOMATIC, TERMINAL, NULL, EXIDVER, * 

LINSTAT=«OUT OF SERVICE 1 , * 

B S CO DE= EBCDIC, ASCII, TRANSCODE, * 

CONVTAB=EBCDIC, ASCII, TRANSCODE, TEXTMODE, ABB, ABC, * 

RDYMSG=symbolic address, * 

ERRMSG=symbolic address, * 

GENPOLL=YES, * 

POOLCNT=number, * 

TCTUAL=number,0, * 
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OOTQ=symbolic name, * 

POOL=YES, * 
QUEUEID=hexadecimal number 

symbol DFHTCT TYPE=TERMINAL, * 

TRMIDNT=name, * 

TRMPRTY=number,0, * 

TRMMODL=number, character, * 

TRMTYPE=1030,1050, 1053, 1130, 2020,2260, L2260, 2265, * 

2740, 2740/2760, 2741C,2741E, 2770, 2780, 2980, * 

3275, 3277, L3277, 3284, L3284, 3286, L3286, 3735, 7770, * 

SYS/3, SYS/7, S360,CRLP,DASD,T APE, TWX,U/R, * 

CLASS=(CONV, BATCH, VIDEO, HARDCOPY,BISYNC, AUDIO) , * 

LVUNIT=number, * 

LASTTRM=LINE,GACB,POOL, * 

TRMADDR=address, name, * 

TRMSTAT= (TRANS ACTION, TRANSCEIVE, RECEIVE, 'OUT OF SERVICE',* 

INPUT) , * 

COMPAT=NO, (number of characters, number of lines, * 

device type, model number), * 

FEATURE= (PTRADAPT,SELCTPEN,AUDALARM,COPY,BUFEXP, * 

UCTRAN,DCKYBD) , * 

P0LLPOS=number, * 

TRANSID=name, * 

STN2980=number, * 

TAB2980=number,0, * 

TIOAL=number, * 

TCTUAL=number 

symbol DFHTCT TYPE=7770MSG, * 
MESSAGE=' message' 

DFHTCT TYPE=FINAL 

FILE CONTROL TABLE (FCT) 

DFHFCT TYPE=INITIAL, * 
SUFFIX=XX 

DFHFCT TYPE=DATASET, * 

DATASET=name, * 

ACCMETH=BDAM,ISAM,DL/I, * 
SERVREQ= (GET, PUT, UPDATE, NEWREC,INDACC, SEGMENT, BROWSE, * 

KEY,NOEXCTL) , * 

BLKKEYL=decimal value, * 

EXTENT=number, * 

CYLOFL=number, * 

INDAREA=symbolic name, * 

INDSlZE=number, * 

INDSKIP=YES, * 

MSTIND=YES, * 

NRECDS=number, * 

IOSIZE=number, * 

IOWORK=symbolic name, * 

DEVICE= (n,m) , (2314,2314) , * 

SRCHM=YES, number, ~~ * 

VERIFY=YES, * 

RELTYPE=DEC,HEX,BLK, * 

LRECL= (length, length) , * 

BLKSIZE= (length, length) , * 

RKP=number, * 

RECFORM=(f or mat, characteristic, DCB record format), * 

OPEN-INITIAL, DEFER RED, * 
KEYLEN=length 

207 



DFHFCT TYPE=INDACC, * 

OBJDSID=name, * 

IARLKP=number, * 

IALKFL=length, * 

IADADMI=RELREC,KEY, * 

IADIII=h.exadecimal character, * 
DUPDSlD=name 

DFHFCT TYPE=SEGHEAD, ' * 

SEGLENG=length, * 

INDDISP=number, * 
TSEGIND=BIT, DISPLACEMENT 

DFHFCT TYPE=SEGDEF, * 

SEGNAME=name, * 

SEGCHAR= (format, alignment) , * 
SEGLENG=length 

DFHFCT TYPE=SEGSET, * 

SEGSET=name, * 
SEGNAME= (namel ,. . . ,nameN) 

DFHFCT TYPE=SEGLAST 

DFHFCT TYPE=FINAL 

DFHFCT TYPE=LOGICMOD 

DESTI NATION CONTROL TABLE (DCT) 

DFHDCT TYPE=INITIAL, * 

SUFFIX=XX, * 

TRNSUFX=(XX,.. .) , * 
SEPASMB=YES,NO 

DFHDCT TYPE=SDSCI, * 

DSCNAME=name, * 

MODNAME=narae, * 

DEVICE=1403, 1404, 1443, 1445, 231 1,231 4, 3330, TAPE, * 

BLKSIZE=length, * 

DEVADDR=symbolic address, * 

RECFORM=FIXUNB,FIXBLK,VARUNB,VARBLK, UNDEFINED, * 

FILABL=STD,NO, * 

TYPEFLE=INPUT, OUTPUT, RDBACK, * 

RECSIZE=length, * 

REWIND=UNLOAD,NORWD, LEAVE, REREAD, * 

TPMARK=NO, * 

BUFNO=number,1, * 

ERROPT=SKIP, IGNORE, * 
SUFFIX=XX 

DFHDCT TYPE=EXTRA, * 

DSCNAME=name, * 

DESTID=name, . ■ * 

OPEN=INITIAL, DEFER RED, * 
RESIDNT=YES,NO 

DFHDCT TYPE=INTRA, * 

DESTID=name, * 

REUSE=YES,NO, * 

TRIGLEV=number, * 

DESTFAC=TERMINAL,FILE, * 
TRANSID=name 
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DFHDCT TYPE=INDIRECT, 
DESTID=name, 
INDDEST=name 



DFHDCT TYPE=FINAL 



PROGRAM CONTROL TABLE (PCT) 

DFHPCT TYPE=INITIAL, 
SUFFIX=XX 

DFHPCT TYPE=ENTRY, 

TRANSID=name, 

TRNPRTY=decimal value, 001, 
TRANSEC=decimal value,001, 
TWASIZE=decimal value, 0, 
PROGRAM=name, 
TPURGE=YES,NO, 
SPURGE=YES,NO, 
COMPAT=NO, FORMAT ,FULLBUF 

DFHPCT TYPE=FINAL 



PROCESSING PROGRAM TABLE (PPT) 

DFHPPT TYPE=INITIAL, 
SUFFIX=XX 

DFHPPT TYPE=ENTRY, 

PROGRAM=name, 

P G ML A NG= ASSEMBLER, COBOL, PL/I, 

RES=YES,NO, 

RELOAD=YES,NO 

DFHPPT TYPE=FINAL 



SIGN-ON TABLE (SNT) 

DFHSNT TYPE=INITIAL 

DFHSNT TYPE=ENTRY, 

OPNAME=' operator name 1 , 
PASSWRD=password, 
OPIDENT=operator identification, 
SCTYKEY=security key,l, 
OPPRTY=operator priority, 

DFHSNT TYPE=FINAL 



TERMINAL LIST TABLES (TLT) 

DFHTLT TYPE=INITIAL, 
SUFFIX=xx 

DFHTLT TYPE=ENTRY, 

TRMIDNT=terminal identification 

DFHTLT TYPE=FINAL 
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r NAMIC OPEN/CLO SE MACRO INSTRUCTIONS 

DFHOC TYPE=OPEN, * 

DATASET=TRANSDATA, DATABASE, DUMP, * 

LISTADR= (register) , (symbolic register) , YES, * 

SYMBADR=symbolic address, * 

DSETID= (name, (xx) ,. . .) , * 
CHECK=symbolic address 

DFHOC TYPE=CLOSE, * 

DATASET=TRANSD ATA, DATABASE, DUMP, * 

LISTADR= (register) , (symbolic register) , YES, * 

SYMBADR=symbolic address, * 

DSETID= (name,- . .) , * 
CHECK=symbolic address 

DFHOC TYPE=SWITCH, * 
DATASET=DOMP 
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APPENDIX G: EXAMPLES OF USES-WRITTEN TRANSACTIONS 



This section contains examples of user-written transactions. The 
source coding is written in Assembler language. 

EXAMPLE OF A J030 TRANSACTION 

The following example of a 1030 transaction: 

1. Analyzes the terminal transaction code in the first byte of 
data. 

2. Matches the transaction code with the entry in the Program 
Control Table (PCT) for the desired transaction. 

3. Issues a Program Control XCTL macro instruction for the program 
name found in the table search. 

Note: The 1030 transaction must take into account the size of the 
largest Transaction Work Area (TWA) needed by the program to 
which control is to be transferred. 





COPY 


DFHCSADS 




COPY 


DFHTCADS 


TCTTEAR 


EQU 


7 




COPY 


DFHTCTTE 


TIOABAR 


EQU 


6 




COPY 


DFHTIOA 


PCTCBAR 


EQU 


5 




COPY 


DFHPCTDS 


TRAN1030 


CSECT 






ENTRY 


T1030 


T1030 


EQU 


* 




BALR 


2,0 




USING 


*,2 




L 


TCTTEAR, TCAFCAAA 




L 


TIOABAR, TCTTEDA 




L 


PCTCBAR, CSAPCTBA 




MVC 


TIOADBA(80) ,TIOADBA+1 


PCTLOOP 


EQU 


* 




CLC 


PCTTI,TIOADBA 




BE 


TRANCTL 




LA 


PCTCBAR, PCTEA 




CLI 


PCTTI,X»FF» 




BNE 


PCTLOOP 


END 


EQU 


* 




DFHPC 


TYPE=RETURN 


TRANCTL 


EQU 


♦ 




MVC 


TCAPCPI,PCTIPIA 




DFHPC 


TYPE=XCTL 




END 


T1030 



COPY CSA SYMBOLIC STRG DEFN 
COPY TCA SYMBOLIC STRG DEFN 
TERM CONTROL TABLE ADDRESS REG 
COPY TCT SYMBOLIC STRG DEFN 
TERMINAL I/O AREA ADDRESS REG 
COPY TIOA SYMBOLIC STRG DEFN 
PROG CONTROL TABLE ADDRESS REG 
COPY PCT SYMBOLIC STRG DEFN 
CONTROL SECTION - 1030 INPUT ED 
1030 INPUT EDIT ENTRY ADDRESS 
1030 INPUT EDIT ENTRY ADDRESS 
ESTABLISH BASE ADDRESS REGISTER 
USING REGISTER 2 FOR BASE REG 
LOAD FACILITY CONTROL ADDRESS 
LOAD TERMINAL I/O AREA ADDRESS 
LOAD PROGRAM CONTROL TABLE ADDR 
SHIFT INPUT DATA ONE BYTE 
PROGRAM CTL TABLE SEARCH ENTRY 
COMPARE TRANSACTION IDENT 
GO TO TRANSFER CONTROL IF EQUAL 
ADVANCE TO NEXT TABLE ENTRY 
TEST FOR END OF TABLE 
CONTINUE SEARCH IF NOT EQUAL 
END OF TABLE SEARCH ENTRY 
PROGRAM CONTROL RETURN 
TRANSFER CONTROL ENTRY 
MOVE PROGRAM NAME TO TCA 
PROGRAM CONTROL TRANSFER CONTROL 



EXAMPLE OF A 276 TRANSACTION 

The following example of a 2760 transaction: 

1. Analyzes input data that CICS has translated to EBCDIC 
representation. 
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2. Changes index numbers (11, 12) to frame numbers. 

3. Converts horizontal/vertical coordinates received from the 2760 
to points ranging from 1 to 252. These points represent screen 
positions arranged (top to bottom, left to right) on a screen 
of 21 vertical columns and 12 horizontal rows. 

4. Indicates how to detect reserved points on the screen, some of 
which are built into the hardware and some of which are assigned 
by the user. 

5. Shows a procedure for generating the necessary control (function) 
information and Move Amount Character codes so that CICS can 
transmit output data to the 2760. Before output transmission 

to the 2760 occurs, CICS translates the data to 2740 code. 





COPY 


DFHCSADS 




COPY 


DFHTCADS 


TCTTEAR 


EQU 


7 




COPY 


DFHTCTTE 


TIOABAR 


EQU 


6 




COPY 


DFHTIOA 


PCTCBAR 


EQO 


5 




COPY 


DFHPCTDS 


REG8 


EQU 


8 


REG9 


EQU 


9 


REG10 


EQU 


10 


REG15 


EQU 


15 


TEAN2760 


CSECT 






ENTRY 


T2760 


T2760 


EQU 


* 




BALR 


2,0 




USING 


*,2 




L 


TCTTEAR,TCAFCAAA 




L 


TIOABAR, TCTTEDA 




L 


PCTCBAR,CSAPCTBA 




BAL 


REG10,COMPIHV 




CLI 


POINTNO+1,132 




BE 


FORWARD1 




CLI 


POINTNO+1,144 




BE 


FORWARD2 




CLI 


POINTNO+1,156 




BE 


FORWARD3 




CLI 


POINTNO+1,168 




BE 


FORWARDS 




CLI 


POINTNO+1,180 




BE 


FORWARD5 




CLI 


POINTNO+1,240 




BE 


REVERSE1 




CLI 


POINTNO+1,228 




BE 


REVERSE2 




CLI 


POINTNO+1,216 




BE 


REVERSE3 




CLI 


POINTNO+1,204 




BE 


REVERSED 




CLI 


POINTNO+1,192 




BE 


REVERSE5 




CLI 


POINTNO+1,245 




BE 


UNLOAD 




CLI 


POINTNO* 1,246 




BE 


LOAD 




B 


END 


FORWARD1 


EQU 


* 




MVI 


FUNCTION, X«P1« 



COPY CSA SYMBOLIC STRG DEFN 
COPY TCA SYMBOLIC STRG DEFN 
TERM CONTROL TABLE ADDRESS REG 
COPY TCT SYMBOLIC STRG DEFN 
TERMINAL I/O AREA ADDRESS REG 
COPY TIOA SYMBOLIC STRG DEFN 
PROG CONTROL TABLE ADDRESS REG 
COPY PCT SYMBOLIC STRG DEFN 
REGISTER EIGHT 
REGISTER NINE 
REGISTER TEN 
REGISTER FIFTEEN 

CONTROL SECTION - 2760 INPUT ED 
2760 INPUT EDIT ENTRY ADDRESS 
2760 INPUT EDIT ENTRY ADDRESS 
ESTABLISH BASE ADDRESS REGISTER 
USING REGISTER 2 FOR BASE REG 
LOAD FACILITY CONTROL ADDRESS 
LOAD TERMINAL I/O AREA ADDRESS 
LOAD PROGRAM CONTROL TABLE ADDR 
LINK TO COMPUTE 11, 12, H, & V 
FORWARD ONE 

FORWARD TWO 

FORWARD THREE 

FORWARD FOUR 

FORWARD FIVE 

REVERSE ONE 

REVERSE TWO 

REVERSE THREE 

REVERSE FOUR 

REVERSE FIVE 

UNLOAD 

LOAD 



FORWARD, AUTO EOM, MFA DISABLED 
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MVC 


ADVANCE, =HM' 




B 


WR2760 


F0RWARD2 


EQU 


* 




MVI 


FUNCTION, X«F1» 




MVC 


ADVANCE, =H»2» 




B 


WR2760 


F0RWARD3 


EQU 


* 




MVI 


FUNCTION, X»F1» 




MVC 


ADVANCE, =H»3» 




B 


WR2760 


FORWARD** 


EQU 


* 




MVI 


FUNCTION, X»F1» 




MVC 


ADVANCE, =H»4» 




B 


WR2760 


FORWARD5 


EQU 


* 




MVI 


FUNCTION,X»F1» 




MVC 


ADVANCE, = H«5* 




B 


WR2760 


REVERSE1 


EQU 


* 




MVI 


FUNCTION, X^O 1 




MVC 


ADVANCE,=H»1' 




B 


WR2760 


REVERSE2 


EQU 


* 




MVI 


FUNCTION, X»40» 




MVC 


ADVANCE, =H«2' 




B 


WR2760 


REVERSE3 


EQU 


* 




MVI 


FUNCTION, X^O* 




MVC 


ADVANCE, = H»3» 




B 


WR2760 


REVERSE** 


EQU 


* 




MVI 


FUNCTION, X'40« 




MVC 


ADVANCE, =H«4» 




B 


WR2760 


REVERSE5 


EQU 


* 




MVI 


FUNCTION, X»40» 




MVC 


ADVANCE, =H , 5« 




B 


WR2760 


LOAD 


EQU 


* 




MVI 


FUNCTION, X»F1» 




MVC 


ADVANCE, =H«8« 




B 


WR2760 


UNLOAD 


EQU 


* 




MVI 


FUNCTION, X f 40» 




MVC 


ADVANCE, =H«255» 


WR2760 


EQU 


* 




LA 


REG9,3 




STH 


REG9,TIOATDL 




MVC 


TIOADBA(1) , FUNCTION 




BAL 


REG10,COMPADV 




MVC 


TIOADBA+1 (2) , ADVANCE 




DFHTC 


TYPE= (WRITE, OIU) 




B 


END 


END 


EQU 


♦ 




DFHPC 


TYPE=RETURN 


COMPIHV 


EQU 


* 




TR 


TIOADBA+2(2) ,TRTBL 




SR 


REG9,RE69 




IC 


REG9,TIOADBA+2 




SLL 


REG9,5 




SR 


REG8,REG8 




IC 


REG8,TIOADBA+3 




AR 


REG8,REG9 




STH 


REG8,FRAMENO 




TR 


TIOADBA+4(2) ,TRTBL 



FORWARD ONE FRAME 



FORWARD, AUTO EOM, MFA DISABLED 
FORWARD TWO FRAMES 



FORWARD, AUTO EOM, MFA DISABLED 
FORWARD THREE FRAMES 



FORWARD, AUTO EOM, MFA DISABLED 
FORWARD FOUR FRAMES 



FORWARD, AUTO EOM, MFA DISABLED 
FORWARD FIVE FRAMES 



REVERSE, AUTO EOM, MFA DISABLED 
REVERSE ONE FRAME 



REVERSE, AUTO EOM, MFA DISABLED 
REVERSE TWO FRAMES 



REVERSE, AUTO EOM, MFA DISABLED 
REVERSE THREE FRAMES 



REVERSE, AUTO EOM, MFA DISABLED 
REVERSE FOUR FRAMES 



REVERSE, AUTO EOM, MFA DISABLED 
REVERSE FIVE FRAMES 

LOAD 

FORWARD, AUTO EOM, MFA DISABLED 

FORWARD EIGHT FRAMES 

UNLOAD 

REVERSE, AUTO EOM, MFA DISABLED 

REVERSE 255 FRAMES 



LINK TO COMPUTE FRAME ADVANCE 



END OF TABLE SEARCH ENTRY 
PROGRAM CONTROL RETURN 
COMPUTE 11, 12, HORIZ, AND VERT 
TRANSLATE 2 CHARS 11 AND 12 
CLEAR REGISTER NINE 
PLACE 11 IN REGISTER NINE 
MULTIPLY 11 BY 32 
CLEAR REGISTER EIGHT 
PLACE 12 IN REGISTER EIGHT 
SUM OF 11X32 AND 12 IN REG 8 
STORE 2760 FRAME NUMBER 
TRANSLATE 2 CHARS VERT & HORIZ 
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FRAMENO 
POINTNO 
TRTBL 



COMPADV 



FUNCTION 

ADVANCE 

ICXTRTBL 



SR 

IC 

MH 

LR 

SR 

IC 

AR 

LA 

SR 

STH 

BR 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DS 

LH 

SR 

LA 

DR 

STC 

STC 

TR 

BR 

DC 

DS 

DC 

DC 

END 



REG8,REG8 

REG8,TIOADBA+5 

REG8, = HM2« 

REG9,REG8 

REG8,REG8 

REG8,TIOADBA+4 

REG9,REG8 

REG8,255 

REG8,REG9 

REG8, POINTNO 

REG10 

H»0» 

H»0" 

X» 

X 1 

X 1 

X' 

X 1 

x» 
x« 
x» 
x» 

x» 

X 1 
X" 

x« 
x» 

X' 
X 1 

OH 

REG9, ADVANCE 

REG8,REG8 

REG15,32 

REG8,REG15 

REG9 r ADVANCE 



CLEAR REGISTER EIGHT 
PLACE HORIZONTAL IN REGISTER 8 
MULTIPLY HORIZONTAL BY TWELVE 
12H RESULT IN REGISTER NINE 
CLEAR REGISTER EIGHT 
PLACE VERTICAL IN REGISTER 8 
12H + V RESULT IN REGISTER NINE 
LOAD 255 IN REGISTER EIGHT 
255-12H-V RESULT IN REGISTER 8 
STORE 2760 POINT NUMBER 
COMPUTE 11, 12, H, AND V EXIT 
2760 FRAME NUMBER 
2760 POINT NUMBER 



FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF 1 
FFFIFFFFFFFFFFFFFFFFFFFFFFFFFFFF 1 
FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF 1 
FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF' 
OOFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF* 
03FFFFFFFFFFFFFFFFFFFFFFFFFFFFFF 1 
020 5FFFFFFFFFFFFFFFFFFFFFFFFFFFF 1 
FFFJFFFFFFFFFFFFFFFFFFFF01FFFFFF' 
FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF' 
FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF 1 
FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF ' 
FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF 1 
FF070B0F13171B1FFFFFFFFFFFFFFFFF* 
FF060A0E12161A1EFFFFFFFFFFFFFFFF* 
FFFF090D1115191DFFFFFFFFFFFFFFFF' 
FF04080C1014181CFFFFFFFFFFFFFFFF 1 

COMPUTE MANUAL 



REG8,ADVANCE+1 

ADVANCE (2) ,LCXTRTBL 

REG10 

X«00« 

H'O' 

X»407C6050F1619181F2A29282F3A39383» 

X»F4A49484F5A59585F6A69686F7A79787 I 

T2760 



FRAME ADVANCE 
LOAD 2760 MANUAL FRAME ADVANCE 
CLEAR REGISTER EIGHT 
LOAD DIVISOR OF 32 
DIVIDE FRAME ADVANCE BY 32 
STORE SECOND BYTE OF ADVANCE 
STORE FIRST BYTE OF ADVANCE 
TRANSLATE MANUAL FRAME ADVANCE 
COMPUTE FRAME ADVANCE EXIT 
2760 FUNCTION 
2760 MANUAL FRAME ADVANCE 



EXAMPLE OF A 3735 TRANSACTION (Not applicable to CICS/DOS-ENTRY) 
The following example of a 3735 transaction: 

1. Reads data from the 3735 and spools to an extrapartition data 
set. 

2. Upon receipt of the end-of-file condition, writes an FDP header 
record, FDP records, an FDP trailer record, and data. 

3. Sends a powerdown message, 

4. Disconnects the line. 



COPY DFHCSADS 

COPY DFHTCADS 

COPY DFHTCTTE 

COPY DFHTIOA 

COPY DFHTDIA 



COMMON SYSTEM AREA DSECT 
TASK CONTROL AREA DSECT 
TERMINAL CONT TABLE DSECT 
TERMINAL I/O AREA DSECT 
TRANSIENT DATA I/O AREA DSECT 



214 



'RAILER 



WLOOPD 



FINISH 



FORTY 

BLKLGTH 

HREC 



TREC 



MVC 

MVC 

ST 

DFHTC 

B 

EQU 

MVC 

ST 

DFHTC 

EQU 

DFHTD 



L 

SH 

MVC 

MVC 

MVC 

ST 

DFHTC 

B 

EQU 

MVC 

DFHTC 

DFHTC 

DFHPC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 



TCTTE BASE REGISTER 
TIOA BASE REGISTER 
TDIA BASE REGISTER 
PROGRAM BASE REGISTER 
WORK REGISTER 

LOAD PROGRAM BASE REGISTER 

ADDRESSABILITY TO TERM CONT TBL 
ADDRESSABILITY TO TERM I/O AREA 
TEST FOR END-OF-FILE CONDITION 
BATCH READ LOOP 
WRITE DATA RECORD 
TO OUTPUT QUEUE 
DATA IS IN TIOA 
READ NEXT RECORD 
AND TEST FOR END-OF-FILE 
ADDRESSABILITY TO TIOA 
LOOP 

WRITE FDP HEADER RECORD 
ADDRESSABILITY TO TIOA 
MOVE HEADER RECORD TO TIOA 
SPECIFY TIOA ADDRESS 
WRITE TO 3735, SAVE TIOA 
BATCH FDP WRITE LOOP 
GET FDP RECORD 
FROM FDP QUEUE 
SEND TRAILER WHEN DONE 
ADDRESSABILITY TO DATA 
ADJUST FOR EXTRAPARITITION 
MOVE DATA 

TIOADBA+240 (236) , TDIADBA+240 TO TIOA 
TIOATDL, BLKLGTH SET LENGTH FOR WRITE 

TIOABAR, TCTTEDA SPECIFY TIOA ADDRESS 

TYPE= (PUT, SAVE, NOTRANSLATE) WRITE TO 3735 



TCTTEAR 


EQU 


3 


TIOABAR 


EQU 


4 


TDIABAR 


EQU 


5 


BASEREG 


EQU 


6 


WORKREG 


EQU 
CSECT 


7 




BALR 


BASEREG, 




USING 


*, BASEREG 




L 


TCTTEAR, TCAFCAAA 




L 


TIOABAR, TCTTEDA 




DFHTC 


EOF=HEADER 


RLOOP 


EQU 


* 




DFHTD 


TYPE=PUT, 

DESTID=OUTQ, 

TDADDR=TIOADBA 




DFHTC 


TYPE=GET, 
EOF=HEADER 




L 


TIOABAR, TCTTEDA 




B 


RLOOP 


HEADER 


EQU 


* 




L 


TIOABAR, TCTTEDA 




MVC 


TIOATDL(7) ,HREC 




ST 


TIOABAR, TCTTEDA 




DFHTC 


TYPE= (PUT, SAVE) 


WLOOPF 


EQU 


* 




DFHTD 


TYPE=GET, 

DESTID=FDPQ, 

QUEZERO=TRAILER 




L 


TDIABAR, TCATDAA 




SH 


TDIABAR, FORTY 




MVC 


TIOADBA(240) ,TDIADBA 



WLOOPF 
* 

TI0ATDL(7) ,TREC 
TIOABAR, TCTTEDA 
TYPE= (PUT, SAVE) 
* 

TYPE=GET, 
DESTID=DATQ, 
QUEZERO=FINISH 
TDIABAR, TCATDAA 
TDIABAR, FORTY 
TIOADBA(240) ,TDIADBA 



LOOP 

WRITE FDP TRAILER RECORD 

MOVE TRAILER RECORD TO TIOA 

SPECIFY TIOA ADDRESS 

WRITE TO 3735, SAVE TIOA 

BATCH DATA WRITE LOOP 

GET DATA 

FROM DATA QUEUE 

EXIT WHEN DONE 

ADDRESSABILITY TO DATA 

ADJUST FOR EXTRAPARTITION 

MOVE DATA 



TIOADBA+240 (236) , TDIADBA+240 TO TIOA 



TIOATDL, BLKLGTH 
TIOABAR, TCTTEDA 
TYPE= (PUT, SAVE) 
WLOOPD 
* 

TIOATDL (7) ,PWRDWN 

TYPE=PUT 

TYPE=DISC 

TYPE=RETURN 

H^O* 

H»476' 

H«3« 

C 1 » 

X»00C600» 

H»3» 

C» • 

X»00C500« 



SET LENGTH FOR WRITE 

SPECIFY TIOA ADDRESS 

WRITE TO 3735, SAVE TIOA 

LOOP 

END UP 

MOVE POWER DOWN MESSAGE TO TIOA 

SEND POWER DOWN MESSAGE 

DISCONNECT LINE REQUEST 

EXIT 



NULL F NULL 



NULL E NULL 
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PWRDWN 


DC H • 3 » 




DC C» • 




DC X»00D700» 




LTORG 




END 



POWER DOWN MESSAGE 
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.INDEX, 

This index has been prepared by an automated 

indexing program. Your comments and suggestions 

will be appreciated. 

The intent is to list primary page 

references first. 



AACA 169 

ABB 32,37,181-183,15,54,62,68,20 3,206 

ABB CODE 68 

ABB SPECIFIES CONVERSION 36 

ABB TRANSMISSION CODE 36 

ABC 32,37, 15, 54, 62, 68, 203,206 

ABC CODE 68 

ABC SPECIFIES CONVERSION 36 

ABC TRANSMISSION CODE 36 

ABEND 173-174, 129, 146,192 

ABEND CODE 169,171 

ABEND CODE INDICATES 169 

ABEND TASK 128 

ABNORMAL CONDITION INVALID ERROR CODE 169 

ABNORMAL CONDITION LINE ENTRY 

DIAGRAM OF THE TERMINAL 123 
ABNORMAL CONDITION PROGRAM 23,162,177,176 
ABNORMAL TERMINATION COMPLETE DATE 156 
ABORT 173-174 

ABORT TERMINAL WRITE REQUESTS 126 
ACB'S 46 

ACCESS 88,113,120-121,1,9,99,114 
ACCESS DL/I 

ACCESS METHOD 6,32,63,82,199 
ACCESSED UNDER CICS/OS 82 
ACCMETH 82-84,32-33,37,196,24,62-63,66,182-183 

191,79-80,189,15,54,81,92,179-181,184-185 
186-189,202,20 6-207 
ACCTID 19-20,14,201 
ACQUISITION 39,15,203 
ACQUISITION INDICATES INPUT 40 
ACTAD 38,15,203 
ACTION 140-143,124,153,171 
ACTION QUEUE PURGE DYNAMIC OPEN/CLOSE 17 
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DUMP MANAGEMENT 1,155,158 
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ESTABLISH BASE ADDRESS REGISTER USING ?1 1-212 
ESTABLISH CONTROL SECTION 108 
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EXISTING CUSHION 154 
EXISTING DFHTEP 24 
EXIT 118,143,149,215 
EXIT ROUTINE 

USER-WRITTEN 39,37,40-42, 116, 1 19 ,27-28,30,14 8-149, 17E 
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GC28-6647 

GC28-6704 

GC30-20 04 

GC30-2024 

GC30-3001 

GC30-5001 

GC34-0013 

GE 21,45 

GENERATE LINKAGE 

GENERATE SEGSET 

GENERATE TCAM SUPPORT 24 

GENPOLL 68-69,54,62,206 

DISCUSSION OF 66 
GH20-1028 50 
GRAPHIC 62-63,196,54,206 
GRAPHIC ATTENTION PROGRAM 
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FEATURE PROGR PL/I INTERFACE 18 
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ASSEMBLY OF THE 48 
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FILE MANAGEMENT 2,82,155,158,80,89,116 
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FINAL SIGN-ON TABLE 209 
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FIXED LENGTH 

PCI FIELDS OF 69 
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I/O ERROR INFORMATION 120 
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ID VERIFICATION 58-59 
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INDIRECT ACCESSING 8 
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INPUT STEP 
INPUT TCTLE 
INPUT TCTTE 

SPECIAL 145,140 
INPUT TIOA BIT 1-7 
INPUT TPROCESS QUEUE 
INPUT USER EXIT 149,140 
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IPL 129 
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ISAM DATA SETS 84-85,87 
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LOGIC MODULE 100,103-104,109,93,96 
LOGICAL 113 
LOGICAL IOCS 96 
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68,127,129,143,157,172,176,207 
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